# Wechat Article Search

> 微信公众号文章智能搜索工具。通过关键词检索获取文章列表，返回标题、摘要、发布时间、来源公众号等详细信息。

- Skill: `zsxink/wechat-article-search` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add zsxink/wechat-article-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zsxink/wechat-article-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zsxink (https://skillmd.com/u/zsxink)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/zsxink/wechat-article-search

---


# 微信公众号文章搜索说明

## 适用场景

- 用户说“帮我搜某个关键词的公众号文章/最近文章”
- 需要快速拿到：标题、摘要、发布时间、公众号名称、可访问链接

## 工作流程

### 步骤1: 确认已安装依赖包
该脚本依赖 NodeJS 依赖包 `cheerio`，进入技能目录安装：

```bash
cd skills/wechat-article-search && npm install
```

### 步骤2: 确认搜索词语数量
1、 确认关键词与数量

### 步骤3: 执行搜索命令
1、执行搜索命令（默认会自动尝试解析真实微信文章链接）

```bash
node scripts/search_wechat.js "关键词"
```

## 特殊流程（可选）
1) 执行包含数量限制的搜索命令

```bash
node scripts/search_wechat.js "关键词" -n 15
```

2) 如果用户需要保存结果到文件，执行命令

```bash
node scripts/search_wechat.js "关键词" -n 20 -o result.json
```

3) 如果用户需要 JSON 格式输出，执行命令

```bash
node scripts/search_wechat.js "关键词" json
```

## 参数说明

- `query`：搜索关键词（必填）
- `-n, --num`：返回数量（默认 10，最大 50）
- `-o, --output`：输出 JSON 文件路径（可选）
- `-r, --resolve-url`：解析真实的微信文章URL（默认启用）
- `--no-resolve-url`：跳过真实链接解析，直接返回搜狗转链
- `json, --json`：直接输出 JSON 格式数据，便于程序处理

## 输出格式

### 格式化输出（默认）

以易读的文本格式输出搜索结果，每篇文章包含以下信息：

```
序号. 文章标题
📌 来源: 公众号名称 | ⏰ 时间信息
💡 文章内容概要
🔗 [查看详情](<完整链接>)

```

**时间信息格式**：
- 如果有完整时间戳：`HH:MM (相对时间描述)`，例如：`23:45 (1小时前)`
- 如果只有相对时间：直接显示，例如：`2小时前`

**输出特点**：
- 每篇文章之间有空行分隔
- 来源和时间在同一行显示
- 链接显示完整的URL地址，使用 `[查看详情](<链接>)` 格式

### JSON 输出（使用 `json` 参数）

```json
{
  "query": "搜索关键词",
  "total": 10,
  "articles": [
    {
      "title": "文章标题",
      "source": "公众号名称",
      "datetime": "2026-03-08 10:30:00",
      "date_text": "2026年03月08日",
      "date_description": "2小时前",
      "summary": "文章摘要",
      "url": "https://mp.weixin.qq.com/s/...",
      "url_resolved": true
    }
  ]
}
```

**JSON 字段说明**：
- `title`：文章标题
- `source`：来源公众号名称
- `datetime`：文章发布时间（中国时区，格式：YYYY-MM-DD HH:mm:ss）
- `date_text`：日期描述（格式：YYYY年MM月DD日）
- `date_description`：相对时间描述（如"2小时前"、"1天前"、"刚刚"）
- `summary`：文章摘要
- `url`：文章链接（可能为真实微信链接或搜狗转链）
- `url_resolved`：是否成功解析到真实微信链接（`true`/`false`）

### 输出说明
- 所有链接使用 `[查看详情](<链接>)` 格式，可以正确处理特殊字符
- 文章已按发布时间降序排序（最新在前）
- 只显示最近60天内的文章，自动过滤旧内容
- 时间优先从页面script标签中的时间戳解析,如果没有时间戳则尝试从文本提取

## 常见问题处理

- 结果为空：尝试更换关键词、更少的特殊字符、或稍后重试
- 解析真实 URL 失败：这是常态（反爬限制）；可提示用户用浏览器打开中间链接

## 注意事项

- 本工具仅用于学习和研究目的，请勿用于商业用途或大规模爬取。
- 使用本工具时请遵守相关网站的使用条款和规定。
- 过度使用可能导致 IP 被封禁，请谨慎使用。