reach-mcp

A controllable multi-source search MCP server for AI agents. Search Reddit, X, YouTube, Hacker News, GitHub, arXiv, Polymarket, 雪球, V2EX, B站, 小宇宙 and more -- you pick the sources, the window, and whether to synthesize. 26 sources across Chinese & English platforms, with adjustable time window, source/category scoping, and optional LLM synthesis.

---

Why

last30days (mvanhorn/last30days-skill) wraps the search in a fixed pipeline: the agent passes a query and gets back a finished brief. It can't choose which sources to hit, can't widen or narrow the time window (hardcoded to 30 days), can't see the raw scored rows, and can't reuse them. Every call re-searches everything.

reach-mcp keeps the same core machinery -- parallel multi-source fetch, engagement-based scoring, cross-source dedup/clustering, an optional LLM-synthesized cited brief -- and exposes it as a plain MCP server whose knobs the agent controls per call:

• 🔌 Pick your sources. sources=["reddit","arxiv","xueqiu"] or omit for all configured ones.
• 📅 Pick your window. days=7 for this week, days=180 for the half-year -- no longer fixed at 30.
• 🪓 Decide what matters. synthesize=false returns raw scored rows for the agent to reason over itself; synthesize=true (default) also runs an LLM rerank + brief. max_chars_per_item sets each row's text-snippet length (default 500) -- raise it for fuller CN posts, lower it to save tokens.
• 🌐 Chinese & English sources in one call -- 雪球, V2EX, B站, 小宇宙, 小红书 alongside Reddit, X, YouTube, HN, GitHub, arXiv and the rest.
• 🛡️ Polite by default -- per-host pacing, honors Retry-After, bounded timeouts. Never hammers a site.

Sources (25)

Tier	Source	Backend	Credential
Free core	reddit	RSS + scrape	none
	hackernews	Algolia API	none
	bluesky	AT Protocol (public)	BSKY_HANDLE/BSKY_APP_PASSWORD (optional)
	github	GitHub API	GH_TOKEN (optional, for higher rate limits)
	arxiv	arXiv API	none
	techmeme	scrape	none
	polymarket	public API	none
	stocktwits	public API	none
	web	Searxng + Brave (optional)	SEARXNG_URL; BRAVE_API_KEY optional ($5/mo)
	dripstack	DripStack API (free, keyless)	none
	rss	feedparser	RSS_FEEDS (comma-separated feed URLs)
Video	youtube	yt-dlp metadata; captions via fetch_content	YTDLP_PROXY (optional)
Chinese	xueqiu	API (login cookie)	XUEQIU_COOKIE
	v2ex	API	none
	bilibili	bili-cli (preferred) / public API fallback	none (install bili for stability)
	xiaoyuzhou	public API	XIAOYUZHOU_ACCESS_TOKEN (login); WHISPER_BASE_URL (for fetch_content transcription)
	xiaohongshu	xiaohongshu-mcp companion	XHS_MCP_URL
Login-gated (off by default)	x	cookies	AUTH_TOKEN/CT0
	truthsocial	Mastodon API	TRUTHSOCIAL_TOKEN
	linkedin	Apify (public posts) + Searxng fallback + ScrapeCreators (optional)	APIFY_API_TOKEN ($5/mo); SEARXNG_URL for fallback; SCRAPECREATORS_API_KEY optional
	tiktok	Apify / OpenCLI / ScrapeCreators	APIFY_API_TOKEN ($5/mo); SCRAPECREATORS_API_KEY; or opencli on PATH
	instagram	Apify / OpenCLI / ScrapeCreators	APIFY_API_TOKEN ($5/mo);