微信公众号文章搜索

按关键词发现微信公众号文章，并把可核验的搜索结果整理给用户。默认使用内置 Python 脚本访问搜狗微信搜索；脚本依赖 requests 与 beautifulsoup4。当本机缺少 Python、 依赖未安装、来源限流或页面结构暂时不可解析时，再使用 WebSearch / WebFetch 做明确 标注的降级检索。

运行依赖

需要 Python 3.10+、requests 和 beautifulsoup4。执行前先检查：

python3 --version
python3 -c "import requests, bs4"

如果 Python 包缺失，先向用户说明需要安装依赖，并在用户同意后执行：

python3 -m pip install -r "${CLAUDE_SKILL_DIR}/requirements.txt"

不要静默安装依赖，也不要改动用户现有的 Python 环境。

请求策略

• requests 负责 HTTP 会话、Cookie 和超时，BeautifulSoup 负责解析搜索结果 DOM。
• 每次请求从有限的浏览器 User-Agent 池中选择一个，并在请求前访问搜狗视频入口预热会话。
• 搜索请求会带基础搜狗 Cookie，并叠加预热响应提供的 SNUID；这只是兼容搜狗搜索页的 请求策略，不代表拥有微信文章访问权限。
• 仍然采用低频人工请求、固定延迟和一次重试；遇到验证码、反爬或限流就停止。

执行流程

1. 从用户请求提取关键词、数量和是否需要直达微信链接。数量未指定时用 10，最大 50； 不要为了默认值额外追问。
2. 先运行脚本。${CLAUDE_SKILL_DIR} 在 nxs 与 Claude Code 中都会展开为当前 Skill 的真实目录：

python3 "${CLAUDE_SKILL_DIR}/scripts/search.py" "关键词" --num 10

3. 读取 stdout JSON，按结果格式回答。不要把脚本的“0 条”扩写成“网上没有”； 它只表示本次来源没有返回可解析结果。
4. 只有用户明确要求 mp.weixin.qq.com 直达链接，或后续任务确实需要抓取正文时，才使用 --resolve-url。链接解析会逐条增加请求，建议一次不超过 10 篇：

python3 "${CLAUDE_SKILL_DIR}/scripts/search.py" "关键词" --num 5 --resolve-url

5. 用户要求保存时才传 --output，优先写入用户指定目录；未指定目录时先给结果，不要自行 把文件散落在 workspace 根目录：

python3 "${CLAUDE_SKILL_DIR}/scripts/search.py" "关键词" --num 20 --output "research/wechat-results.json"

排序

默认保持搜索相关性顺序。用户明确要“最新”“最近”时，使用 --sort latest；这只会对本次 检索到的结果按可解析发布时间降序排列，不能宣称覆盖全部公众号文章：

python3 "${CLAUDE_SKILL_DIR}/scripts/search.py" "关键词" --num 20 --sort latest

降级检索

遇到以下情况时停止重复调用脚本，改走降级链路：

• python3 不存在，或 stderr 的错误码是 dependency_missing；
• stderr 的错误码是 antispider、rate_limited 或 page_changed；
• 连续一次正常重试后仍是网络错误。

使用 WebSearch 搜索：

site:mp.weixin.qq.com/s "关键词"

对最多 5 个高相关结果用 WebFetch 核验标题、公众号和发布时间。只返回工具真实提供的 字段；无法核验的字段写“未核验”，不要从 URL、摘要或账号习惯推断。回答中说明“搜狗微信 检索不可用，以下来自公开网页索引”，避免把降级结果伪装成同一数据源。

如果 WebSearch 也未配置或失败，直接说明当前缺少可用搜索来源，并给出可执行建议： 稍后重试、缩短关键词、去掉特殊字符，或让用户提供候选链接。不要循环请求触发更严格限流。

结果格式

脚本输出一个 JSON 对象：

{
  "query": "AI Agent",
  "sort": "relevance",
  "total": 1,
  "fetched_at": "2026-07-28T08:00:00.000Z",
  "articles": [
    {
      "title": "文章标题",
      "url": "https://weixin.sogou.com/link?...",
      "summary": "搜索结果摘要",
      "datetime": "2026-07-27 10:30:00",
      "date_text": "2026年07月27日",
      "date_description": "2026年07月27日",
      "source": "公众号名称"
    }
  ]
}

向用户展示时优先使用紧凑编号列表，每条包含：

标题 — 公众号 · 发布时间
摘要
链接

• url_resolved: true 表示已解析为微信直达链接。
• url_resolved: false 时保留可访问的搜狗中间链接，不要声称它是直达链接。
• datetime 为空表示来源没有提供可解析时间；不要补造日期。
• 用户要求“整理参考资料”时，可在结果之后按主题聚类，但保持原始链接与来源可追溯。

使用边界

• 本 Skill 用于低频、人工发起的资料发现，不用于批量采集、持续爬取或规避验证码与明确封禁。
• 尊重站点条款和访问限制；出现验证码、反爬或限流就停止自动重试。
• 搜索结果只证明索引页当时返回了该条目，不证明文章观点、事实或时效性。需要引用文章 内容时，再获取原文并独立核验。