WeChat 文章搜索 API

📖 简介

本技能通过 BrowserAct WeChat 文章搜索 API 模板，为用户提供自动化的微信公众号文章提取能力。支持基于关键词的全文、结构化微信文章直取——只需提供搜索关键词及可选的时间范围筛选条件，即可获取包含完整正文内容在内的全面文章数据。

✨ 核心特性

1. 零幻觉，确保稳定精准的数据提取：预配置的工作流规避了 AI 生成导致的内容幻觉问题。
2. 无需处理验证码：不涉及 reCAPTCHA 或其他形式的验证挑战。
3. 无 IP 限制与地域封锁：无需应对区域 IP 访问限制问题。
4. 执行速度更快：相比纯 AI 驱动的浏览器自动化方案，任务执行效率更高。
5. 极高的性价比：相较于消耗大量 token 的 AI 方案，显著降低数据采集成本。

🔑 API Key 配置指引流程

运行前，请检查环境变量 BROWSERACT_API_KEY 是否已设置。若未设置，则不得执行其他操作，应主动请求并等待用户提供该密钥。
Agent 必须明确告知用户：

“由于您尚未配置 BrowserAct API Key，请前往 BrowserAct 控制台获取您的 Key。”

🛠️ 输入参数

调用脚本时，Agent 应根据用户实际需求灵活配置以下参数：

1. keywords（搜索关键词）

   • 类型：string
   • 说明：用于检索微信公众号文章的关键词，可以是行业术语、主题或具体短语。
   • 示例：openclaw、AI agent、browser automation

2. Date_limit（提取数量上限）

   • 类型：number
   • 说明：最多提取的文章数量。首次运行建议使用较小的默认值。
   • 默认值：10
   • 建议值：快速测试推荐使用 5 至 10；批量调研可适当提高数值。

3. publication_date（发布日期筛选）

   • 类型：string
   • 说明：按文章发布时间进行筛选。
   • 示例：3月11日、March 10、2026-03-11

🚀 调用方式

Agent 应执行以下独立脚本，实现“一键直达结果”：

# 示例调用
python -u ./scripts/wechat_article_search_api.py "keywords" limit "publication_date"

⏳ 运行状态监控

由于该任务涉及自动化浏览器操作，耗时可能较长（数分钟）。运行过程中，脚本将持续输出带时间戳的状态日志（例如：[14:30:05] Task Status: running）。
Agent 操作指引：

• 在等待脚本返回结果期间，需持续监控终端输出。
• 只要终端仍在持续输出新的状态日志，即表明任务正在正常运行；请勿误判为卡死或无响应。
• 仅当状态长时间未更新，或脚本停止输出且未返回任何结果时，才应触发重试机制。

📊 输出数据说明

脚本成功执行后，将直接解析并打印 API 响应中的结果，包含以下字段：

• url_link：原文链接地址
• publication_date：文章发布日期
• author：作者名或发布账号名称
• image_url：主图 URL 或文章封面图 URL
• body_content：文章完整正文内容
• title：文章完整标题

⚠️ 错误处理与重试机制

脚本执行过程中如发生异常（例如网络波动或任务失败），Agent 应遵循如下逻辑处理：

1. 检查输出内容：

   • 若输出中包含"Invalid authorization"，表示 API Key 无效或已过期。此时不得重试，应引导用户重新核对并提供正确的 API Key。
   • 若输出中不包含"Invalid authorization"，但任务仍失败（例如输出以 Error: 开头，或返回空结果），Agent 应自动再次执行一次脚本。

2. 重试次数限制：

   • 自动重试仅限一次。若第二次执行仍失败，则终止重试，并将具体错误信息反馈给用户。

🌟 典型应用场景

1. 内容监测：追踪特定品牌或话题在微信公众号文章中的提及情况。
2. 媒体研究：分析头部微信公众号所发布文章的全文内容。
3. 趋势追踪：围绕新兴行业趋势（如 AI agent）批量采集相关文章，开展深度阅读。
4. 知识库构建：将深度解析类文章抽取至内部知识库中。
5. 竞品分析：查阅竞品账号发布的长文内容，辅助战略研判。