AutoSearch v2 M1 skeleton
Project description
AutoSearch
Deep research MCP server for AI developers.
39 search channels across academic, developer, and Chinese platforms — cited results, no hallucination.
Docs • Install • Channels • MCP Tools
Install
# Option 1 — npm (recommended, no Python setup required)
npm install -g autosearch-ai
autosearch-ai init
# Option 2 — pip
pip install autosearch
autosearch init
init auto-detects your LLM providers and writes the MCP config to ~/.claude/mcp.json and ~/.cursor/mcp.json.
What it does
AutoSearch runs as an MCP server inside Claude Code, Cursor, or any MCP-compatible client. Your AI agent calls tools like run_channel, delegate_subtask, and consolidate_research — AutoSearch searches real sources and returns structured, cited results.
- 39 channels: arxiv, PubMed, GitHub, Hacker News, Reddit, Xiaohongshu, Weibo, Twitter, Douyin, and more
- 22 MCP tools: search, delegation, loop management, citation export
- 5 search modes: academic / news / chinese_ugc / developer / product — auto-detected from query
- No hallucination: every result cites the source URL
MCP Tools
| Tool | Description |
|---|---|
run_clarify |
Detect query intent, pick mode and channels |
run_channel |
Search one channel with dedup + BM25 ranking |
delegate_subtask |
Run multiple channels in parallel |
consolidate_research |
Compress evidence to prevent context overflow |
loop_init / loop_update / loop_gaps |
Deep research loop |
citation_create / citation_add / citation_export |
Citation management |
list_skills / list_channels / list_modes |
Discover available resources |
doctor |
Full channel health report with fix hints |
Supported Channels
Run autosearch doctor to see live status. Generated from autosearch/skills/channels/*/SKILL.md.
Tier 0 - always-on (21)
| Channel | Languages | Description | Typical yield |
|---|---|---|---|
| arxiv | en | Use for academic preprint searches in CS/ML/physics when query is English or mixed and expects peer-reviewed or preprint papers. | medium-high |
| crossref | en | Cross-publisher scholarly search via the Crossref DOI registry, useful for journal articles, book chapters, and citation-linked research metadata. | medium |
| dblp | en | Computer science bibliography search — technical papers, proceedings, and journal articles indexed by venue, author, and year. | medium |
| ddgs | en, mixed | DuckDuckGo Search — free general web search with no auth, use as broad default for any English or mixed query. | medium |
| devto | en, mixed | Developer blog articles tagged by technology topic, via the public dev.to API. | medium |
| github | en | Use for code-level, issue-level, and repository discovery when query involves a library, framework, or implementation detail. | high |
| google_news | en, mixed | Current news headlines aggregated across publishers via Google News RSS (English US feed). | high |
| hackernews | en | Use for real-time developer discussion, tooling opinions, and early-stage product signals from the HN community. | medium-high |
| huggingface_hub | en, mixed | Discover open machine learning models on Hugging Face Hub via the public model search API. | high |
| infoq_cn | zh, mixed | Chinese engineering articles covering architecture, AI, and enterprise tech from InfoQ 中文, via public RSS feed. | medium |
| kr36 | zh, mixed | Chinese tech business news, startup funding, and industry analysis from 36kr. | medium |
| openalex | en, mixed | Search scholarly works through OpenAlex's public works search API with open-access URL fallback. | high |
| package_search | en, mixed | Discover packages across PyPI (exact-name lookup) and npm (full-text search) registries. | medium |
| papers | en, mixed | Multi-source academic paper search (arxiv, pubmed, biorxiv, medrxiv, google_scholar) via paper-search-mcp. | high |
| podcast_cn | zh, mixed | Chinese-language podcasts searchable via the Apple iTunes store public API. | low |
| en, mixed | Reddit community discussions, user experience reports, and topic debates via the public search.json endpoint. | medium | |
| sec_edgar | en | US public company filings (10-K, 10-Q, 8-K) via SEC EDGAR full-text search — financial and regulatory disclosures for research. | medium |
| sogou_weixin | zh, mixed | Chinese WeChat Official Account articles via the public Sogou WeChat search SERP. | high |
| stackoverflow | en, mixed | Programming Q&A with community-voted answers across 200+ technical tags via api.stackexchange.com. | high |
| wikidata | en, mixed | Structured entity data (people, places, concepts) from Wikidata knowledge graph. | medium |
| wikipedia | en, mixed | Authoritative encyclopedia articles via the Wikipedia Action API (English edition). | high |
Tier 1 - env-gated (1)
| Channel | Languages | Required env | Description | Typical yield |
|---|---|---|---|---|
| youtube | en, zh, mixed | env:YOUTUBE_API_KEY | Use for video tutorial discovery, conference talks, technical walkthroughs, and product demos. | medium |
Tier 2 - BYOK paid (8)
| Channel | Languages | Required env | Description | Typical yield |
|---|---|---|---|---|
| bilibili | zh, mixed | env:TIKHUB_API_KEY | Chinese tech video platform with tutorials, conference recordings, and uploader-authored articles, via TikHub. | medium |
| douyin | zh | env:TIKHUB_API_KEY | Chinese short-video content with product demos, tech reviews, and viral trends, via TikHub. | medium |
| kuaishou | zh, mixed | env:TIKHUB_API_KEY | Chinese short-video platform with lifestyle, humor, regional culture, and product demos, via TikHub. | medium |
| tiktok | en, mixed | env:TIKHUB_API_KEY | Global short-video platform with creator content, product demos, viral trends, and topical reactions, via TikHub. | medium |
| en, mixed | env:TIKHUB_API_KEY | Real-time public discourse including product launches, tech announcements, and breaking news, via TikHub. | medium | |
| zh, mixed | env:TIKHUB_API_KEY | Chinese microblog platform for real-time opinion, trending topics, and event-level commentary in Chinese discourse, via TikHub. | medium | |
| xiaohongshu | zh, mixed | env:TIKHUB_API_KEY | Chinese lifestyle + experience-sharing notes with strong product/beauty/travel/food coverage, via TikHub. | high |
| zhihu | zh, mixed | env:TIKHUB_API_KEY | Chinese Q&A platform with deep technical discussions and user experience reports — use when query is Chinese or mixed and targets developer opinions, comparisons, or tutorials. | medium-high |
License
MIT.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file autosearch-2026.4.23.4.tar.gz.
File metadata
- Download URL: autosearch-2026.4.23.4.tar.gz
- Upload date:
- Size: 218.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
992e36fc11e2cc35fa56acd807ba622ac37a9c87bb509ca54d0efd670363490a
|
|
| MD5 |
847c77b55a3463af9187b97146479967
|
|
| BLAKE2b-256 |
a223dea4a272965562a9b86ffb299b8383a5d0cfdf6fafaf544b6a11f44f5910
|
File details
Details for the file autosearch-2026.4.23.4-py3-none-any.whl.
File metadata
- Download URL: autosearch-2026.4.23.4-py3-none-any.whl
- Upload date:
- Size: 326.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df247bf1dd312760081793e9db1618d74c8aa3ea706feba47f6ccdb6cf9b57f0
|
|
| MD5 |
00e8c25bc1cc22c09c0099cb20201ef5
|
|
| BLAKE2b-256 |
85ad80cd6b0bbcb5ce5800f8c310cc7883d41f159a53cbe6edeca175104e5777
|