WeChat Search Skill

使用合规的三层策略搜索微信公众号文章：优先调用合法的搜索 API，仅在必要时回退至尊重网站规则的网页抓取方式。

功能特性

• 合规设计：优先使用合法搜索 API，严格遵守 robots.txt 协议及速率限制
• 三层策略：
  • 第一层（主策略）：OpenClaw web_search（Brave Search API）
  • 第二层（备用策略）：Tavily Search API（当 Brave Search 不可用时启用）
  • 第三层（兜底策略）：直接从微信搜索页面抓取结果
• 最新结果优先：默认返回最近发布的 5 篇文章（可配置）
• 时间筛选支持：支持按日期范围和时效性（如“近一周”）过滤结果
• 多种输出格式：支持文本、JSON 和 Markdown 格式输出

前置依赖

• OpenClaw Web 工具：需已启用 web_search 和 web_fetch 工具
• API 密钥（非必需，但强烈推荐）：
  • Brave Search API Key（用于主策略搜索）
  • Tavily API Key（用于备用策略搜索，已在您的环境中预配置）

使用方法

基础搜索

wechat-search "人工智能"

高级选项

# 返回 10 条结果（而非默认的 5 条）
wechat-search "机器学习" --max-results 10

# 搜索过去一周内发布的内容
wechat-search "大模型" --past-week

# 自定义日期范围
wechat-search "AI应用" --from 2026-01-01 --to 2026-02-01

# 输出 JSON 格式
wechat-search "开源AI" --output json

# 强制指定搜索策略
wechat-search "最新技术" --strategy tavily_only

配置说明

创建配置文件 ~/.openclaw/wechat-search-config.json 以自定义行为：

{
  "defaultMaxResults": 5,
  "maxResultsLimit": 20,
  "requestDelayMs": 5000,
  "cacheDurationHours": 1,
  "userAgent": "OpenClaw-WeChat-Search-Bot/1.0 (+https://github.com/your-username/wechat-search-skill)"
}

搜索策略详情

第一层：OpenClaw Web Search（Brave Search）

• 使用 Brave Search API，并通过 site:mp.weixin.qq.com 进行站点限定
• 在 API Key 配置完成后最快且最稳定
• 尊重搜索引擎自身的索引与排序逻辑

第二层：Tavily Search API

• 当 Brave Search 不可用或请求失败时自动启用
• 利用 Tavily 的 AI 增强搜索能力，并限定于微信公众号站点
• 提供高质量、高相关性且覆盖全面的结果

第三层：直接网页抓取

• 作为最终兜底方案，在两个 API 均不可用时启用
• 直接从搜狗微信搜索（sogou.com/weixin）抓取搜索结果页
• 实现合理请求间隔，并严格遵守 robots.txt 规则
• 解析 HTML 页面以提取文章元数据（如标题、发布时间、摘要等）

合规性与伦理规范

• 遵守 robots.txt：主动检查并遵循目标站点的 robots.txt 指令
• 速率限制：两次请求之间至少间隔 5 秒
• 身份标识透明：User-Agent 字符串清晰表明爬虫身份
• 仅访问公开内容：仅检索对公众完全开放的文章资源
• 不保留原始内容：不存储文章全文，仅缓存元数据

错误处理机制

• 网络异常时自动重试（最多 3 次）
• 三层搜索策略间平滑降级与回退
• 提供清晰易懂的错误信息，便于调试定位
• 对缺失 API Key 的场景进行优雅容错处理

未来增强方向

• RSS 订阅源集成支持
• 文章正文内容自动摘要生成
• 作者关注/公众号订阅管理功能
• 更丰富的筛选与排序选项

本技能旨在兼顾实用性与责任感，在为用户提供有价值的微信公众号内容的同时，严格遵守平台规则与法律法规。