微信公众号文章搜索说明

适用场景

• 用户说“帮我搜某个关键词的公众号文章/最近文章”
• 需要快速拿到：标题、摘要、发布时间、公众号名称、可访问链接

工作流程

步骤1: 确认已安装依赖包

该脚本依赖NodeJS依赖包 cheerio，建议先执行全局安装或在项目中安装：

npm install -g cheerio

步骤2: 确认搜索词语数量

1、 确认关键词与数量

步骤3: 执行搜索命令

1、执行搜索命令（默认会自动尝试解析真实微信文章链接）

node scripts/search_wechat.js "关键词"

特殊流程（可选）

1. 执行包含数量限制的搜索命令

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

2. 如果用户需要保存结果到文件，执行命令

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

3. 如果用户需要 JSON 格式输出，执行命令

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

参数说明

• query：搜索关键词（必填）
• -n, --num：返回数量（默认 10，最大 50）
• -o, --output：输出 JSON 文件路径（可选）
• -r, --resolve-url：解析真实的微信文章URL（默认启用）
• --no-resolve-url：跳过真实链接解析，直接返回搜狗转链
• json, --json：直接输出 JSON 格式数据，便于程序处理

输出格式

格式化输出（默认）

以易读的文本格式输出搜索结果，每篇文章包含以下信息：

序号. 文章标题
📌 来源: 公众号名称 | ⏰ 时间信息
💡 文章内容概要
🔗 [查看详情](<完整链接>)

时间信息格式：

• 如果有完整时间戳：HH:MM (相对时间描述)，例如：23:45 (1小时前)
• 如果只有相对时间：直接显示，例如：2小时前

输出特点：

• 每篇文章之间有空行分隔
• 来源和时间在同一行显示
• 链接显示完整的URL地址，使用 [查看详情](<链接>) 格式

JSON 输出（使用 json 参数）

{
  "query": "搜索关键词",
  "total": 10,
  "articles": [
    {
      "title": "文章标题",
      "source": "公众号名称",
      "datetime": "2026-03-08 10:30:00",
      "date_text": "2026年03月08日",
      "date_description": "2小时前",
      "summary": "文章摘要",
      "url": "https://mp.weixin.qq.com/s/...",
      "url_resolved": true
    }
  ]
}

JSON 字段说明：

• title：文章标题
• source：来源公众号名称
• datetime：文章发布时间（中国时区，格式：YYYY-MM-DD HH:mm:ss）
• date_text：日期描述（格式：YYYY年MM月DD日）
• date_description：相对时间描述（如"2小时前"、"1天前"、"刚刚"）
• summary：文章摘要
• url：文章链接（可能为真实微信链接或搜狗转链）
• url_resolved：是否成功解析到真实微信链接（true/false）

输出说明

• 所有链接使用 [查看详情](<链接>) 格式，可以正确处理特殊字符
• 文章已按发布时间降序排序（最新在前）
• 只显示最近60天内的文章，自动过滤旧内容
• 时间优先从页面script标签中的时间戳解析,如果没有时间戳则尝试从文本提取

常见问题处理

• 结果为空：尝试更换关键词、更少的特殊字符、或稍后重试
• 解析真实 URL 失败：这是常态（反爬限制）；可提示用户用浏览器打开中间链接

注意事项

• 本工具仅用于学习和研究目的，请勿用于商业用途或大规模爬取。
• 使用本工具时请遵守相关网站的使用条款和规定。
• 过度使用可能导致 IP 被封禁，请谨慎使用。