WeChat Official Account Article Search Instructions

Applicable Scenarios

• When users say "Help me search for official account articles/recent articles on a certain keyword"
• Need to quickly obtain: title, abstract, publication time, official account name, accessible link

Workflow

Step 1: Confirm that dependencies are installed

cheerio

npm install -g cheerio

Step 2: Confirm the number of search terms

1. Confirm keywords and quantity

Step 3: Execute the search command

1. Execute the search command (will automatically try to parse the real WeChat article link by default)

node scripts/search_wechat.js "关键词"

Special Process (Optional)

1. Execute the search command with quantity limit

node scripts/search_wechat.js "关键词" -n 15

1. If users need to save results to a file, execute the command

node scripts/search_wechat.js "关键词" -n 20 -o result.json

1. If users need JSON format output, execute the command

node scripts/search_wechat.js "关键词" json

Parameter Description

• query

  : Search keyword (required)

• -n, --num

  : Number of returned results (default 10, maximum 50)

• -o, --output

  : Output JSON file path (optional)

• -r, --resolve-url

  : Parse real WeChat article URL (enabled by default)

• --no-resolve-url

  : Skip real link parsing and directly return Sogou redirect link

• json, --json

  : Directly output data in JSON format for easy program processing

Output Format

Formatted Output (Default)

No. Article Title
📌 Source: Official Account Name | ⏰ Time Information
💡 Article Content Summary
🔗 [View Details](<Full Link>)

• If there is a complete timestamp:

  HH:MM (Relative Time Description)

  , e.g.:

  23:45 (1 hour ago)

• If only relative time is available: Display directly, e.g.:

  2 hours ago

• Empty line separation between each article
• Source and time are displayed on the same line
• Links display full URL addresses in the format

  [View Details](<Link>)

JSON Output (Using

json

parameter)

{
  "query": "Search Keyword",
  "total": 10,
  "articles": [
    {
      "title": "Article Title",
      "source": "Official Account Name",
      "datetime": "2026-03-08 10:30:00",
      "date_text": "March 08, 2026",
      "date_description": "2 hours ago",
      "summary": "Article Abstract",
      "url": "https://mp.weixin.qq.com/s/...",
      "url_resolved": true
    }
  ]
}

• title

  : Article title

• source

  : Source official account name

• datetime

  : Article publication time (China Time Zone, format: YYYY-MM-DD HH:mm:ss)

• date_text

  : Date description (format: YYYY-MM-DD)

• date_description

  : Relative time description (e.g., "2 hours ago", "1 day ago", "just now")

• summary

  : Article abstract

• url

  : Article link (may be a real WeChat link or Sogou redirect link)

• url_resolved

  : Whether the real WeChat link was successfully parsed (

  true

  /

  false

  )

Output Instructions

• All links use the format

  [View Details](<Link>)

  , which can correctly handle special characters
• Articles are sorted in descending order of publication time (latest first)
• Only articles from the last 60 days are displayed, old content is automatically filtered out
• Time is parsed from the timestamp in the page script tag first; if there is no timestamp, try to extract from text

Common Problem Handling

• Empty results: Try changing keywords, using fewer special characters, or retrying later
• Failure to parse real URL: This is normal (anti-crawling restrictions); you can prompt users to open the intermediate link with a browser

Notes

• This tool is for learning and research purposes only. Do not use it for commercial purposes or large-scale crawling.
• Please comply with the terms of use and regulations of relevant websites when using this tool.
• Excessive use may lead to IP blocking. Please use it with caution.