VNHAX
vnhax
Panniantong/Agent-ReachPublic
1.4k
Fork8.9k
90,600
3 branches · 14 tags
P
Panniantongfeat: add automated failover routing for Reddit and Bilibili backends
7d4e21a3 hours ago
.github/workflows
ci: test platform adapter health checks across runtimes
2 days ago
agent_reach/core
feat: implement dynamic backend routing & health checker
3 hours ago
agent_reach/platforms
feat: update Twitter, Reddit, and XiaoHongShu adapters
5 hours ago
agent_reach/mcp
feat: Model Context Protocol (MCP) server endpoints
yesterday
docs
docs: update multi-language READMEs and quickstart guide
4 hours ago
LICENSE
docs: MIT license
2 months ago
README.md
docs: add trendshift badge & supported platforms matrix
3 hours ago
pyproject.toml
release: bump version to v2.3.0
3 hours ago
README.md
Verified Technical Teardown
👁️ AGENT REACH90.6K+ STARS (+979 TODAY)15+ PLATFORMS$0 API FEESLICENSE: MIT
Agent Reach - Give your AI Agent one-click access to the entire internet
Panniantong / Agent-Reach — Multi-Platform Retrieval

Agent Reach: One-Click Internet Access for Any AI Agent

Modern AI agents hit severe roadblocks when querying live social networks: commercial APIs charge hundreds of dollars per month, Reddit blocks cloud server IPs with 403 errors, and video/community platforms require login state. Agent Reach gives your AI Agent reliable, zero-API-cost internet access across 15+ platforms with automated backend health checking and failover routing.

$0 API Cost
Bypasses Expensive Paywalls
15+ Channels
Twitter, Reddit, Bilibili, YouTube
Auto-Failover
Seamless Fallback Backends
doctor Diagnostic
1-Command Health Verifier

❤️ Sponsors & Ecosystem Partners

Support open-source development · pnt01@foxmail.com
BrowserAct

Extracts any data from complex websites (Amazon, LinkedIn, X, Google Maps) in a real stealth browser with residential proxies and CAPTCHA handling.

Try Free (1,000 credits) ↗
Tencent Cloud (OpenClaw)

Deploy OpenClaw on Tencent Cloud Lighthouse in seconds, connect Agent Reach through chat, and add internet access to your agent setup.

Learn More ↗
CoreClaw

Web scraping platform with 100+ ready-made data collection tools for Amazon, TikTok, Google Maps, Instagram, and YouTube.

Free $3 Trial ↗
AstraFlow ModelVerse

One-click access to 200+ models, including leading open-source models such as Kimi K3, DeepSeek V3, and Qwen 2.5/3.

Explore Models ↗

Why Do You Need Agent Reach?

AI Agents can already access the internet — but “can go online” is barely the start. The most valuable information lives across social and niche platforms where information density is highest, but each has strict barriers:

Platform Pain PointReality Without Agent ReachWith Agent Reach
Twitter / X APIPay-per-use, moderate usage ~$215/monthFree via local cookie auth & twitter-cli
RedditCloud server IPs get blocked with 403 ForbiddenOpenCLI desktop browser session reuse
XiaoHongShuStrict mandatory login to browse notesZero automated login, uses existing session
BilibiliBlocks server/overseas IPs (412 on yt-dlp)Auto-switched to bili-cli with 0 login needed

What You Might Want to Know Before Using

💰 Completely Free

All tools are open source, all APIs used are free. The only possible cost is an optional server proxy ($1/mo) if hosting in restricted networks. Local machines need no proxy.

🔒 Privacy Safe

Cookies stay strictly on your local disk. Never uploaded to cloud servers. Fully open source code you can audit anytime.

🔄 Kept Up to Date

Every platform routes through an ordered primary + fallback list. When an upstream path changes, Agent Reach auto-switches so you never notice.

🤖 Works with Any Agent

Claude Code, OpenClaw, Cursor, Windsurf, Codex, Antigravity — any agent capable of running shell commands.

CHANNELS

Supported Platforms (15)

PlatformSetup LevelActive BackendNotes & Capabilities
🌐Web PagesZero configJina Reader (⭐9.8K)Converts any URL into token-efficient Markdown with no API key.
🐦Twitter / XCookietwitter-cli ▸ OpenCLI ▸ birdCookie unlocks search, timelines, and tweet details without $215/mo API.
📕XiaoHongShuOpenCLIOpenCLI ▸ xiaohongshu-mcpOpenCLI reuses existing user-controlled Chrome session without automating login.
📘FacebookOpenCLIOpenCLI (Desktop)Desktop browser session reuse bypassing restricted Graph APIs.
📷InstagramOpenCLIOpenCLI (Desktop)Desktop Chrome session reuse; avoids fragile Instaloader scrapers.
💼LinkedInZero configlinkedin-mcp ▸ Jina ReaderPublic pages read via Jina Reader; full profiles via MCP.
💻V2EXZero configPublic JSON APIZero auth required. Premier Chinese technical developer community.
📈Xueqiu (Snowball Finance)CookieBrowser CookieFinancial community discussions and stock trends.
🎙️Xiaoyuzhou PodcastFree keyGroq Whisper API (Free)Full podcast audio to text transcript in seconds.
🔍Web SearchAuto-configuredExa via mcporterAuto-configured during install, free, no API key needed.
📦GitHubZero configgh CLI (Official)Public repos work instantly; gh auth login unlocks issues and PRs.
📺YouTubeZero configyt-dlp (⭐154K)Fetches full transcripts and subtitles across 1,800+ video sites.
📺BilibiliZero configbili-cli ▸ OpenCLINo login required; yt-dlp was 412-blocked so Agent-Reach uses bili-cli.
📡RSS FeedsZero configfeedparser (⭐2.3K)Python ecosystem standard feed reader.
📖RedditOpenCLIOpenCLI ▸ rdt-cliBypasses server IP 403 blocks via local browser session or rdt login.

Quick Start & Common Commands

Pass this instruction directly to your AI Agent:
Install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
Run Diagnostic Health Check:
agent-reach doctor
Install as Global Agent Skill:
npx skills add Panniantong/Agent-Reach@agent-reach
Search Reddit Posts:
agent-reach query reddit "best local LLMs"
Search Twitter / X:
agent-reach query twitter "Claude 3.7 benchmarks"

Design Philosophy & Core Principles

Agent Reach is a capability layer, not yet another tool. It sits one level above any specific implementation: it handles selection, installation, health checks, and routing, not the reading itself. Reading is done by your Agent calling upstream tools directly with zero wrapper overhead.

🔌 Ordered Backend Routing

Each platform maintains an ordered list (primary + fallbacks). When an upstream tool is blocked (e.g. Bilibili 412 on yt-dlp), Agent Reach routes to bili-cli seamlessly.

🩺 Real Active Probing

agent-reach doctor tests live network responses, verifying that endpoints return actual content rather than merely checking if a CLI binary is installed.

🛡️ Safe Local-First Cookies

Agent Reach never automates login or exfiltrates credentials. OpenCLI attaches only to an existing user-controlled desktop Chrome session.

Project Structure

channels/
├── web.py          → Jina Reader
├── twitter.py      → twitter-cli ▸ OpenCLI ▸ bird
├── youtube.py      → yt-dlp
├── github.py       → gh CLI
├── bilibili.py     → bili-cli ▸ OpenCLI ▸ search API (yt-dlp retired)
├── reddit.py       → OpenCLI ▸ rdt-cli (login required)
├── facebook.py     → OpenCLI (desktop browser session)
├── instagram.py    → OpenCLI (desktop browser session)
├── xiaohongshu.py  → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── linkedin.py     → linkedin-mcp ▸ Jina Reader
├── rss.py          → feedparser
├── exa_search.py   → Exa via mcporter
└── __init__.py     → Channel registry (for doctor health checks)
🤝 Contributing Guidelines

Contributions to new platform channels, failover scrapers, and doctor diagnostics are welcome. Submit pull requests or report broken access paths on GitHub Issues.

⚖️ License: MIT

Released under the MIT License. Free for both individual and commercial agentic pipelines.