前言¶

做品牌监测、竞品动态收集或内部知识库沉淀时，最耗时的一步往往不是分析，而是把公众号文章一篇篇抓下来：搜索结果页只能看到标题，点进去还要处理反爬、验证码和 IP 地域限制，正文、作者、发布日期很难一次性结构化拿到。

下面介绍的 wechat-article-search-api-skill 就是针对这个环节的：输入关键词和可选的发布日期，直接拿到结构化的公众号文章全文。

这是什么¶

wechat-article-search-api-skill 是一个基于 BrowserAct WeChat Article Search API 模板的采集工作流，由 ClawHub 上的 @ccmagia2-gif 发布维护，版本 v1.0.1，License 为 MIT-0。

它把「搜索微信文章」和「提取正文」两件事合并成一次脚本调用，用预置的浏览器自动化工作流执行，不依赖大模型现场生成内容，因此结果稳定、可复现。

官方地址：https://api.skillhub.cn/org-b6kzcl68/wechat-article-search-api-skill
上游仓库：https://clawhub.ai/ccmagia2-gif/wechat-article-search-api-skill

核心功能¶

官方 SKILL.md 列出的能力如下：

1、按关键词搜索公众号文章，可附加发布日期筛选。
2、返回结构化字段：原文链接、发布日期、作者或公众号名称、封面图地址、完整正文、标题。
3、预置工作流避免 AI 幻觉，数据提取稳定。
4、不需要处理验证码（reCAPTCHA 等）。
5、不需要处理 IP 地域限制或 geo-blocking。
6、相比纯 AI 驱动的浏览器自动化，执行更快，且数据获取成本更低。
7、内置一次性自动重试。

安装与启用¶

官方页面给出的安装命令是 ClawHub / OpenClaw 生态的 CLI 安装方式：

openclaw skills install @ccmagia2-gif/wechat-article-search-api-skill

页面同时标注了 npx skills 这条 CLI 入口。安装完成后，Agent 在遇到相关需求时应主动加载该技能。

需要说明的是：官方资料里没有给出 Cursor、Codex CLI、Claude Code 各自的专用安装命令，本文不臆测，只写已核实到的上述方式。

配置 API Key¶

这个 Skill 依赖 BrowserAct API，运行前需要检查环境变量 BROWSERACT_API_KEY。

官方流程是：

1、检查 BROWSERACT_API_KEY 是否已设置。
2、如果没有设置，不要自行采取其他动作，向用户索取并等待。
3、告知用户：

Since you have not configured the BrowserAct API Key, please go to the BrowserAct Console to get your Key.

也就是用户需要到 BrowserAct Console 自行申请 Key，Agent 不做代填。

输入参数¶

调用脚本时，Agent 应根据用户需求配置以下参数。

keywords，搜索关键词，字符串类型。可以是行业词、话题词或具体短语，例如 openclaw、AI agent、browser automation。

Date_limit，提取数量上限，数值类型。默认值 10；官方建议首次运行用 5 到 10 做快速验证，批量研究时再放大。

publication_date，发布日期筛选，字符串类型。支持 3月11日、March 10、2026-03-11 等写法。

典型用法¶

官方给出的调用方式是一条独立脚本，「一条命令，直接出结果」：

python -u ./scripts/wechat_article_search_api.py "keywords" limit "publication_date"

例如按关键词采集、数量上限 10、不筛日期：

python -u ./scripts/wechat_article_search_api.py "AI agent" 10

加上发布日期筛选：

python -u ./scripts/wechat_article_search_api.py "AI agent" 10 "2026-03-11"

路径 ./scripts/wechat_article_search_api.py 是技能包内相对路径，需要在技能安装目录下执行。

运行状态与输出¶

由于这是浏览器自动化任务，单次运行可能持续数分钟。脚本会持续输出带时间戳的状态日志，例如：

[14:30:05] Task Status: running

官方给 Agent 的判断标准是：只要终端还在持续输出新的状态日志，就说明任务在正常推进，不要误判为死锁或无响应；只有在状态长时间不变、或脚本停止输出却没有返回结果时，才考虑触发重试。

运行成功后，脚本直接解析并打印 API 响应，包含以下字段：

1、url_link：原文链接。
2、publication_date：文章发布日期。
3、author：文章作者或发布公众号名称。
4、image_url：文章主图或封面图地址。
5、body_content：完整正文。
6、title：完整文章标题。

错误处理与重试¶

官方规定了两层判断逻辑。

先看输出内容：

1、如果输出包含 Invalid authorization，说明 API Key 无效或已过期。此时不要重试，引导用户重新检查并提供正确的 Key。
2、如果输出不含 Invalid authorization，但任务失败（例如输出以 Error: 开头，或返回空结果），自动再执行一次脚本。

重试上限为一次。第二次仍失败就停止重试，把具体错误信息回报给用户。

适用场景¶

官方列出的典型场景包括：

1、内容监测：追踪公众号文章中对特定品牌或话题的提及。
2、媒体研究：分析头部公众号发布文章的全文。
3、趋势跟踪：收集某个上升行业话题（如 AI agent）的相关文章做系统阅读。
4、知识库建设：把深度长文提取进内部资料库。
5、竞品分析：查看竞品账号发布的完整文章。

注意与限制¶

以下几点需要留意。

需要 API Key：标签为 requires_api_key=true，没有配置 BROWSERACT_API_KEY 就无法运行，且申请需要用户自己去 BrowserAct Console 完成。

运行时间不短：属于浏览器自动化任务，官方明确提示可能耗时数分钟，批量采集时应把等待和轮询预期调好。

关键词决定召回质量：这个 Skill 做的是「按关键词搜索再提取」，召回范围受微信搜索本身覆盖的账号和排序影响，不是全量订阅号抓取。

价格未在资料中给出：是否计费、按量还是按任务，需要到 BrowserAct Console 查看。

该技能在官方简介中还提到，如需新媒体内容研究的完整工作流套件，可在淘宝搜索「AI灵匣」店铺获取完整版。这条信息来自技能自身的描述，本文仅作转述。

小结¶

wechat-article-search-api-skill 的价值在于把「搜索公众号 + 提取正文 + 结构化字段」压缩成一条命令，省去自建采集要面对的验证码、IP 限制和正文解析成本。适合有批量公众号文章采集需求、且愿意配置 BrowserAct API Key 的开发者。

官方地址：https://api.skillhub.cn/org-b6kzcl68/wechat-article-search-api-skill
上游仓库：https://clawhub.ai/ccmagia2-gif/wechat-article-search-api-skill