Wechat Article Search - 微信公众号文章搜索

- 标题
- 摘要
- 发布时间
- 来源公众号
- 链接（可选解析真实微信文章链接）

## 输出格式要求（严格）

当用户要“结果展示”时，必须严格按以下 5 行输出每条结果，不要输出 JSON，不要增加其他字段名：

```text
标题：{title}
摘要：{summary}
发布时间：{publish_time}
来源公众号：{source_account}
链接：{detail_url_or_url_real_or_url}
```

规则：

- 每条结果固定 5 行，字段顺序固定，不可变更。
- 多条结果时，按上述格式重复输出，结果与结果之间空一行。
- 字段无值时统一填 `无`。
- `链接` 字段优先使用 `detail_url`；若无 `detail_url` 则使用 `url_real`；仍无则使用 `url`。

## 依赖

```bash
pip install requests beautifulsoup4
```

## 脚本路径

- `skills/jisu-wechat-article/search.py`

## 使用方式

### 1) 常规搜索

```bash
python3 skills/jisu-wechat-article/search.py "关键词"
```

### 2) 指定数量

```bash
python3 skills/jisu-wechat-article/search.py "关键词" -n 15
```

### 3) 保存到文件

```bash
python3 skills/jisu-wechat-article/search.py "关键词" -n 20 -o out/result.json
```

### 4) 解析真实链接（会额外请求）

```bash
python3 skills/jisu-wechat-article/search.py "关键词" -n 5 -r
```

### 5) 保留 antispider 风控链接（调试用）

```bash
python3 skills/jisu-wechat-article/search.py "关键词" -n 5 -r --keep-antispider
```

### 6) 抓取正文（详情）

```bash
python3 skills/jisu-wechat-article/search.py "极速数据入驻 ClawHub" -n 5 --fetch-content
```

可与 `-r` 组合：

```bash
python3 skills/jisu-wechat-article/search.py "极速数据入驻 ClawHub" -n 5 -r --fetch-content
```

### 7) 正文抓取限制说明（重要）

当前环境下，`--fetch-content` 常会被搜狗/微信风控拦截（`content_status=blocked`），导致拿不到正文。这是站点风控行为，不是技能报错。

推荐做法：

1. 先用本技能获取搜索结果，拿到 `detail_url`（或 `url`）。
2. 将该搜狗链接在浏览器中打开，完成跳转后获取真实微信文章链接（`https://mp.weixin.qq.com/...`）。
3. 再用真实微信链接查看正文内容。

结论：技能可稳定返回“标题/摘要/发布时间/来源公众号/链接”，正文抓取成功率受风控影响，不保证每次可用。

### 8) `content_status=blocked` 标准回复模板

当正文抓取被拦截时，按下面模板返回（可替换占位符）：

```text
当前无法直接抓取正文（命中风控），但已为你找到文章信息：
标题：{title}
摘要：{summary_or_无}
发布时间：{publish_time_or_无}
来源公众号：{source_account_or_无}
链接：{detail_url_or_url}

请将上述链接在浏览器中打开，跳转后复制真实微信文章链接（mp.weixin.qq.com），即可查看正文。
```

## 与 微信公众号管理套件 结合使用

`wechat-mp` 是公众号运营工具集，支持发文到草稿箱、草稿管理、评论管理、用户管理（含黑名单）和数据统计。

推荐组合流程：

1. 用本技能搜索公众号文章，拿到标题、摘要、发布时间、来源公众号和链接；
2. 基于搜索结果整理选题与文案；
3. 用 `wechat-mp` 将内容发布到公众号草稿，并继续做评论/用户/数据运营。

相关链接：

- wechat-mp（ClawHub）：<https://clawhub.ai/jisuapi/wechat-mp>

## 参数说明

- `query`：搜索关键词（必填）
- `-n, --num`：返回数量（默认 10，最大 50）
- `-o, --output`：输出 JSON 文件路径（可选）
- `-r, --resolve-url`：尝试解析微信文章真实链接（会额外请求每条结果）
- `--fetch-content`：尝试抓取文章正文文本（会额外请求每条结果）
- `--content-max-chars`：正文文本最大长度（默认 6000）
- `--ua`：自定义 User-Agent
- `--ua-rotate`：启用内置 User-Agent 轮换
- `--retries`：每个请求最大重试次数（默认 1）
- `--retry-delay`：重试间隔秒数（默认 0.3）
- `--keep-antispider`：保留 `antispider` 风控链接（默认不保留）
- `--timeout`：请求超时秒数（默认 15）

## 输出字段（items 每条）

- `title`：文章标题
- `url`：搜索结果中的文章链接（可能是中间跳转）
- `detail_url`：详情页链接（始终返回；优先真实链接，失败时回退到搜索链接）
- `summary`：摘要
- `publish_time`：发布时间（页面可提取则返回）
- `source_account`：来源公众号名称
- `url_real`：真实微信文章链接（仅 `-r` 时尝试返回）
- `resolve_status`：真实链接解析状态（仅 `-r` 时返回，`ok/blocked/empty`）
- `content_url`：用于抓取正文的文章链接（仅 `--fetch-content`）
- `content_title`：正文页标题（仅成功抓取时返回）
- `content_text`：正文文本（仅 `--fetch-content`）
- `content_status`：正文抓取状态（`ok/blocked/no_mp_url/fetch_error/parse_empty`）
- `content_error`：正文抓取失败原因（仅失败时）

## 注意事项

- 本技能是网页抓取工具，请遵守目标站点使用条款与 robots 规则。
- 过高频率调用可能触发风控或封禁。
- 若你需要更强安全边界，建议在受限网络环境中运行。

## 关于极速数据

**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下 API：

- **生活常用**：IP 查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA 赛事数据，邮编查询，WHOIS 查询，识图工具，二维码生成识别，手机空号检测
- **交通出行**：VIN 车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN 识别
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
- **位置服务**：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在 API 详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。