WeChat Search Skill

Search for WeChat Official Account (微信公众号) articles using a compliant, three-layer approach that prioritizes legal search APIs and falls back to respectful web scraping when needed.

Features

Compliant Design: Prioritizes legal search APIs, respects robots.txt and rate limits
Three-Layer Strategy:
- Primary: OpenClaw web_search (Brave Search API)
- Secondary: Tavily Search API (if Brave unavailable)
- Fallback: Direct page fetching from WeChat search
Recent Results: Returns the 5 most recent articles by default (configurable)
Time Filtering: Support for date range and recency filters
Multiple Output Formats: Text, JSON, and markdown formats available

Prerequisites

OpenClaw Web Tools: Requires web_search, web_fetch tools to be available
API Keys (optional but recommended):
- Brave Search API Key (for primary search)
- Tavily API Key (for secondary search, already configured in your environment)

Usage

Basic Search

wechat-search "人工智能"

Advanced Options

# Return 10 results instead of default 5
wechat-search "机器学习" --max-results 10

# Search within past week
wechat-search "大模型" --past-week

# Custom date range
wechat-search "AI应用" --from 2026-01-01 --to 2026-02-01

# JSON output format
wechat-search "开源AI" --output json

# Force specific strategy
wechat-search "最新技术" --strategy tavily_only

Configuration

Create ~/.openclaw/wechat-search-config.json to customize behavior:

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

Search Strategy Details

Layer 1: OpenClaw Web Search (Brave Search)

Uses Brave Search API with site:mp.weixin.qq.com filter
Fastest and most reliable when API key is configured
Respects search engine's indexing and ranking

Layer 2: Tavily Search API

Activated when Brave Search is unavailable or fails
Uses Tavily's AI-powered search with WeChat site restriction
Provides high-quality, relevant results with good coverage

Layer 3: Direct Web Fetch

Final fallback when both APIs are unavailable
Scrapes WeChat search results directly from搜狗微信搜索
Implements proper delays and respects robots.txt
Parses HTML to extract article metadata

Compliance & Ethics

Respects robots.txt: Checks and follows robots.txt directives
Rate limiting: Minimum 5-second delay between requests
Transparent identification: Clear User-Agent string identifying the bot
Public content only: Only accesses publicly available articles
No data retention: Does not store full article content, only metadata

Error Handling

Automatic retry on network failures (up to 3 attempts)
Graceful fallback between all three search strategies
Clear error messages for debugging
Handles API key missing scenarios gracefully

Future Enhancements

RSS feed integration support
Article content summarization
Author/subscription management
Enhanced filtering options

This skill is designed to be both useful and responsible, providing access to valuable WeChat Official Account content while respecting platform rules and legal requirements.

wechat-search

Safety Notice

Copy this and send it to your AI assistant to learn