mcpField
W
wechat-article-search

wechat-article-search

github.com/zjp1997720生产力78663 次安装4 天前更新
代码仓库

关于 wechat-article-search

按关键词搜索微信公众号文章的命令行技能，可返回标题、摘要、发布时间、公众号名称和链接，并支持设置结果数量、保存 JSON 及尝试解析真实文章链接。

主要功能

  1. 01按关键词搜索文章
  2. 02默认返回 10 条
  3. 03结果数量可设为最多 50 条
  4. 04输出为 JSON 文件
  5. 05可选解析真实文章链接

适用场景

  1. 01查找某主题的近期公众号文章
  2. 02将搜索结果保存为 JSON
  3. 03尝试把中间链接解析为文章链接

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zjp1997720/zhijian-skills --skill wechat-article-search

安装后在 Claude Code 中输入/wechat-article-search确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
package-lock.json
package.json
agents/
interface.yaml
openai.yaml
scripts/
search_wechat.js
tests/
parser.test.js
tests/fixtures/
search-results.html

详细介绍

来自项目 README

微信公众号文章搜索说明

适用场景

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

工作流程

步骤1: 定位脚本和依赖

先把 SKILL_DIR 设为本次读取的 SKILL.md 所在目录（软链接先解析真实目录）。依赖在该目录内管理；已安装时直接使用，仅缺少依赖时按下文的仓库约定安装，不全局安装，也不在用户项目根目录安装。

步骤2: 使用已有输入

从用户请求提取关键词；未指定数量时用默认 10 条。已有关键词和范围时直接执行；只有缺少搜索主题时才询问。输出文件仅在用户要求保存时创建。

步骤3: 执行搜索命令

1、执行常规搜索命令

node "$SKILL_DIR/scripts/search_wechat.js" "关键词"

特殊流程（可选）

  1. 执行包含数量限制的搜索命令
node "$SKILL_DIR/scripts/search_wechat.js" "关键词"  -n 15
  1. 如果用户需要保存结果到文件，执行命令
node "$SKILL_DIR/scripts/search_wechat.js" "关键词" -n 20 -o result.json
  1. 若想要获取微信文章域名的真实链接”，执行如下命令
node "$SKILL_DIR/scripts/search_wechat.js" "关键词" -n 5 -r

参数说明

  • query：搜索关键词（必填）
  • -n, --num：返回数量（默认 10，最大 50）
  • -o, --output：输出 JSON 文件路径（可选）
  • -r, --resolve-url：尝试把中间链接解析成微信文章真实链接（会额外请求每条结果）

输出字段（文章对象）

文章标题、文章地址、文章概要、发布时间、来源公众号名称

常见问题处理

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

注意事项

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

Vault 适配说明（deepsight_vault 专属，原版无此段）

以下内容由大鹏的 vault 自动追加，用于把本 skill 接入 Obsidian 仓库生态。原版说明见上方。

依赖安装（本仓库约定）

本 skill 在仓库内自包含依赖，不要全局安装。首次使用或克隆仓库后，在本 skill 目录执行一次：

cd "$SKILL_DIR"
npm install

cheerio 会装到本目录的 node_modules/，已被 .gitignore 排除。脚本通过 Node 的向上查找机制能 require('cheerio')，无需配 NODE_PATH。

单一真源与同步
  • 真源：本 Portfolio 的 skills/wechat-article-search/。
  • 安装入口可以是宿主 Skill 目录内的软链接；以本次读取路径解析后的真实目录为准，不假设所有宿主共享同步脚本。
  • 修改本 Portfolio 的 skills/wechat-article-search/ 真实来源；先解析软链接，不把安装入口当另一份源码。
与 wxmp-article-harvester 的衔接

两个 skill 职责互补，可串联使用：

环节skill输入输出
关键词发现（本 skill）wechat-article-search关键词，如「AI Agent」文章列表 JSON（标题/链接/摘要/来源/时间）
按账号/URL 抓正文wxmp-article-harvester公众号名或 mp.weixin.qq.com/s/... 链接结构化索引 + Markdown 正文

典型链路：先用本 skill 按关键词发现一批文章 URL 和来源公众号 → 再用 harvester 对感兴趣的账号或具体 URL 抓取正文导出到 ~/.dapeng/wxmp-harvester/exports/。

输出落点建议
  • 临时检索：直接看 stdout JSON，不落盘。
  • 需要留档：用 -o 写到 00_收件箱/Clippings/ 或对应项目的来源目录，文件名带关键词和日期，如 wechat-search-AI培训-2026-07-06.json。
  • 不要把搜索结果散落到仓库根目录。
反爬与免责（重要）
  • 数据源是搜狗微信搜索（weixin.sogou.com），受反爬策略影响，偶发返回空结果或被 antispider 拦截属正常现象，换关键词或稍后重试即可。
  • -r 解析真实链接在反爬收紧时成功率低，失败会保留搜狗中间链接并标记 url_resolved: false。
  • 仅用于学习研究和个人资料整理，不要高频调用、不要做大规模商业爬取。

评论

支持 Markdown