wechat-article-search-api-skill

微信文章搜索 API

📖 简介

此技能通过 BrowserAct 微信文章搜索 API 模板，为用户提供自动化的微信文章提取功能。它支持根据关键词搜索，直接提取结构化的微信文章全文。只需提供搜索关键词和可选的日期筛选条件，即可获取包含全文的全面文章数据。

✨ 功能

1. 杜绝幻觉，确保数据提取稳定、精准：预配置的工作流可避免 AI 生成的幻觉。
2. 无需处理验证码：无需处理 reCAPTCHA 或其他验证挑战。
3. 无 IP 限制或地域封锁：无需处理区域 IP 限制。
4. 执行速度更快：与纯 AI 驱动的浏览器自动化方案相比，任务执行速度更快。
5. 性价比极高：与消耗大量 token 的 AI 方案相比，可显著降低数据获取成本。

🔑 API 密钥配置流程

运行前，检查 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 应执行以下独立脚本，实现“一条命令，直接获取结果”：

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

⏳ 运行状态监控

由于此任务涉及自动化浏览器操作，可能需要较长时间（几分钟）。运行期间，脚本会持续输出带时间戳的状态日志（例如 [14:30:05] Task Status: running）。 Agent 指南：

• 等待脚本返回结果时，持续监控终端输出。
• 只要终端持续输出新的状态日志，就表示任务正常运行；请勿误判为卡住或无响应。
• 只有在状态长时间未变化，或脚本停止输出且未返回结果时，才考虑触发重试机制。

📊 输出数据说明

成功执行后，脚本会解析 API 响应并直接打印结果。结果包括：

• url_link：文章原始 URL
• 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. 竞品分析：审阅竞争对手账号发布的完整文章。