微信公众号文章搜索

技能文档

---
name: wechat-article-search-api-skill
title: 微信公众号文章搜索
category: 内容创作
description: "通过 BrowserAct API 搜索并提取微信公众号文章全文内容，支持关键词搜索、日期筛选和批量提取。当用户需要搜索微信公众号文章、提取公众号全文内容、追踪行业趋势、监控品牌曝光、采集竞品动态、获取公众号文章正文数据时触发。触发词：微信公众号、公众号文章搜索、公众号全文提取、微信内容采集。"
---

# 微信公众号文章搜索 API

## 简介

本技能通过 BrowserAct 微信公众号文章搜索接口，按关键词直接提取全文、结构化的公众号文章数据。只需提供搜索关键词和可选的日期筛选，即可获取包含正文全文的完整文章数据。

## 核心优势

1. **无幻觉，数据精准**：预配置工作流，避免 AI 生成的内容幻觉
2. **无验证码问题**：无需处理 reCAPTCHA 或其他验证挑战
3. **无 IP 限制或地域封锁**：无需处理区域 IP 限制
4. **执行更快**：相比纯 AI 驱动的浏览器自动化方案，任务执行速度更快
5. **极高性价比**：相比消耗大量 Token 的 AI 方案，大幅降低数据采集成本

## 技能工作流

### 步骤1：检查 API Key

运行前检查 `BROWSERACT_API_KEY` 环境变量。如果未设置，不要执行其他操作，要求用户提供。

告知用户：
> "由于您尚未配置 BrowserAct API Key，请前往 [BrowserAct 控制台](https://www.browseract.com/reception/integrations) 获取您的 Key。"

### 步骤2：配置输入参数

根据用户需求灵活配置以下参数：

1. **keywords（搜索关键词）**
   - **类型**：`string`
   - **说明**：用于搜索微信公众号文章的关键词，可以是行业术语、主题或特定短语
   - **示例**：`AI agent`、`人工智能`、`浏览器自动化`

2. **limit（提取数量）**
   - **类型**：`number`
   - **说明**：最大提取文章数量。首次运行建议使用较小的默认值
   - **默认值**：`10`
   - **建议**：快速测试使用 `5` 到 `10`，批量研究可使用更大数值

3. **publication_date（发布日期筛选）**
   - **类型**：`string`
   - **说明**：按发布日期筛选文章
   - **示例**：`3月11日`、`March 10`、`2026-03-11`

### 步骤3：执行搜索脚本

运行以下脚本完成「一条命令，直接出结果」：

```bash
python -u ./scripts/wechat_article_search_api.py "关键词" 提取数量 "发布日期"
```

### 步骤4：监控运行状态

由于涉及自动化浏览器操作，任务可能耗时较长（数分钟）。脚本运行期间会**持续输出带时间戳的状态日志**（如 `[14:30:05] 任务状态: running`）。

注意事项：
- 等待脚本返回结果期间，持续监控终端输出
- 只要终端持续输出新的状态日志，说明任务正常运行，不要误判为卡死或无响应
- 仅在状态长时间不变或脚本停止输出且未返回结果时，才考虑触发重试机制

### 步骤5：解析输出数据

执行成功后，脚本解析并直接打印 API 返回结果，包含以下字段：
- `url_link`：原文链接
- `publication_date`：文章发布日期
- `author`：文章作者或公众号名称
- `image_url`：主图 URL 或文章封面图 URL
- `body_content`：文章正文全文
- `title`：文章完整标题

### 步骤6：错误处理与重试

脚本执行过程中如出现错误（如网络波动或任务失败），按以下逻辑处理：

1. **检查输出内容**：
   - 输出**包含** `"Invalid authorization"` → API Key 无效或已过期，**不要重试**，引导用户重新检查并提供正确的 API Key
   - 输出**不包含** `"Invalid authorization"` 但任务失败（如输出以 `Error:` 开头或返回空结果）→ **自动重试执行一次**

2. **重试上限**：
   - 自动重试仅限 **一次**。若第二次仍然失败，停止重试并向用户报告具体错误信息

## 典型使用场景

1. **内容监控**：追踪特定品牌或话题在微信公众号文章中的提及情况
2. **媒体研究**：分析头部公众号发布文章的全文内容
3. **趋势追踪**：收集关于新兴行业趋势（如 AI Agent）的文章进行深度阅读
4. **知识库建设**：将深度文章提取到内部知识库
5. **竞品分析**：查阅竞品账号发布的长文内容

使用说明

# 微信公众号文章搜索

通过 BrowserAct API 按关键词搜索并提取微信公众号文章全文，支持日期筛选和批量采集。

## 前置条件

配置环境变量 `BROWSERACT_API_KEY`，前往 [BrowserAct 控制台](https://www.browseract.com/reception/integrations) 获取。

## 使用

```bash
# 搜索关键词，默认提取 10 篇
python scripts/wechat_article_search_api.py "AI agent"

# 指定提取数量和日期筛选
python scripts/wechat_article_search_api.py "人工智能" 5 "3月11日"
```

## 工作原理

脚本调用 BrowserAct 微信公众号文章搜索接口，按关键词检索公众号文章并提取结构化数据（标题、作者、日期、正文全文、封面图、原文链接），无需处理验证码或 IP 限制。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。