vex1023 87935b59ce refactor: restructure project with CLI tool, multi-engine support, and skill-builder compliant SKILL.md
- Replace setup.py with pyproject.toml (uv-compatible)
- Add CLI entry point (web-search) with 9 subcommands
- Add multi-engine architecture (14 web + 7 special sources)
- Add WeChat/CLS/WallStreetCN/ArXiv/Twitter search engines
- Remove old src/ and examples/ directories
- Remove redundant requirements.txt and setup.py
- Update README.md and SKILL.md with full documentation
- SKILL.md now compliant with skill-builder standards (frontmatter, triggers, structure)
2026-05-14 16:31:54 +08:00

Web Search Skills

Multi-source web search CLI tool — search across 20+ engines from your terminal.

Quick Start

# Install with uv (recommended)
cd web-search-skills
uv tool install -e .

# Now use globally from anywhere
web-search wechat 蒙面财经
web-search news "AI" -n 5
web-search search "量子计算" -o results.json

Or run directly without install:

python ws.py wechat 蒙面财经

Usage

web-search <command> <query> [options]
Command Description
search Search all sources (default)
web Web search engines (Google, Baidu, DDG)
news News (财联社, 华尔街见闻, RSS)
wechat WeChat public account articles
academic Academic papers (ArXiv)
social Social media (Twitter/X)
rss RSS news feeds
sources List all available search sources
urls Generate search URLs without executing

Options:

Flag Description
-n N Max results per source (default: 10)
-j JSON output
-o FILE Save to JSON file
-s NAME Specific source name(s)
-r cn/global Region filter (web search)
-v Verbose/debug logs

Project Structure

web-search-skills/
├── scripts/
│   ├── cli.py                   # CLI entry point
│   ├── unified_search.py        # Unified search orchestrator
│   ├── core/
│   │   ├── base.py              # SearchResult & SearchEngine base class
│   │   └── config_loader.py     # Load engine config from JSON
│   ├── engines/
│   │   ├── url_engine.py        # URL-template search engines
│   │   └── parser_engines.py    # HTML-parsed search (DuckDuckGo)
│   ├── news/
│   │   ├── cls.py               # 财联社
│   │   ├── wallstreetcn.py      # 华尔街见闻
│   │   └── rss.py               # RSS feeds
│   ├── academic/
│   │   └── arxiv.py             # ArXiv papers
│   ├── wechat/
│   │   └── sogou_weixin.py      # WeChat (via Sogou)
│   └── social/
│       └── twitter.py           # Twitter/X
├── config/
│   └── engines.json             # Search engine definitions
├── ws.py                        # Direct run entry point
├── pyproject.toml               # Package config
├── SKILL.md                     # CodeBuddy skill definition
├── LICENSE
└── README.md

License

MIT

S
Description
A collection of web search tools and skills for enhancing search capabilities
Readme
136 KiB
0 Stars 3 Watchers 0 Forks
Languages
Python 100%