How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/zjp1997720/zhijian-skills --skill wechat-article-searchBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
微信公众号文章搜索说明
适用场景
- 用户说“帮我搜某个关键词的公众号文章/最近文章”
- 需要快速拿到：标题、摘要、发布时间、公众号名称、可访问链接
工作流程
步骤1: 定位脚本和依赖
先把 SKILL_DIR 设为本次读取的 SKILL.md 所在目录（软链接先解析真实目录）。依赖在该目录内管理；已安装时直接使用，仅缺少依赖时按下文的仓库约定安装，不全局安装，也不在用户项目根目录安装。
步骤2: 使用已有输入
从用户请求提取关键词；未指定数量时用默认 10 条。已有关键词和范围时直接执行；只有缺少搜索主题时才询问。输出文件仅在用户要求保存时创建。
步骤3: 执行搜索命令
1、执行常规搜索命令
bash
node "$SKILL_DIR/scripts/search_wechat.js" "关键词"特殊流程（可选）
1) 执行包含数量限制的搜索命令
bash
node "$SKILL_DIR/scripts/search_wechat.js" "关键词" -n 152) 如果用户需要保存结果到文件，执行命令
bash
node "$SKILL_DIR/scripts/search_wechat.js" "关键词" -n 20 -o result.json3) 若想要获取微信文章域名的真实链接”，执行如下命令
bash
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 目录执行一次：
bash
cd "$SKILL_DIR"
npm installcheerio 会装到本目录的 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。- 仅用于学习研究和个人资料整理，不要高频调用、不要做大规模商业爬取。
