Skip to main content

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.

Release License CI Python npm

DocsInstallChannelsMCP 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
reddit 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
twitter en, mixed env:TIKHUB_API_KEY Real-time public discourse including product launches, tech announcements, and breaking news, via TikHub. medium
weibo 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autosearch-2026.4.23.4.tar.gz (218.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

autosearch-2026.4.23.4-py3-none-any.whl (326.2 kB view details)

Uploaded Python 3

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

Hashes for autosearch-2026.4.23.4.tar.gz
Algorithm Hash digest
SHA256 992e36fc11e2cc35fa56acd807ba622ac37a9c87bb509ca54d0efd670363490a
MD5 847c77b55a3463af9187b97146479967
BLAKE2b-256 a223dea4a272965562a9b86ffb299b8383a5d0cfdf6fafaf544b6a11f44f5910

See more details on using hashes here.

File details

Details for the file autosearch-2026.4.23.4-py3-none-any.whl.

File metadata

File hashes

Hashes for autosearch-2026.4.23.4-py3-none-any.whl
Algorithm Hash digest
SHA256 df247bf1dd312760081793e9db1618d74c8aa3ea706feba47f6ccdb6cf9b57f0
MD5 00e8c25bc1cc22c09c0099cb20201ef5
BLAKE2b-256 85ad80cd6b0bbcb5ce5800f8c310cc7883d41f159a53cbe6edeca175104e5777

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page