Agent Reach — Internet Access for Agents
Give AI agents the ability to read the entire internet. One CLI install, zero API fees. Based on Agent Reach (16K+ GitHub stars).
Prerequisites
# Check if installed
agent-reach doctor
# Install if needed
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto
Platform Quick Reference
Zero-Config (works immediately)
# Read any web page (primary)
curl -s "https://r.jina.ai/URL"
# Read any web page (fallback — local, no API dependency)
npx defuddle parse URL --markdown
# YouTube — get video metadata + subtitles
yt-dlp --dump-json "https://youtube.com/watch?v=xxx"
yt-dlp --write-sub --skip-download "URL"
# GitHub — repos, issues, PRs
gh repo view owner/repo
gh search repos "LLM framework" --sort stars
gh issue list -R owner/repo
# Reddit — search and read
rdt search "query"
rdt read POST_ID
# RSS — parse any feed
python3 -c "import feedparser; f=feedparser.parse('URL'); print([e.title for e in f.entries[:10]])"
# Exa semantic search (via MCP)
mcporter call 'exa.web_search_exa(query: "topic", num_results: 10)'
Cookie-Required (configure first)
# Twitter/X — search, read, timeline
twitter search "query" -n 10
twitter tweet URL
twitter timeline -n 20
# Configure Twitter cookies (one-time):
# User exports cookies from Cookie-Editor Chrome extension
agent-reach configure twitter-cookies "COOKIE_STRING"
Multi-Platform Research Pattern
When asked to research a topic, combine platforms:
twitter search "topic" -n 10— real-time discussion and sentimentyt-dlp --dump-json URL— deep-dive video transcriptsgh search repos "topic" --sort stars— implementations and toolsrdt search "topic"— community discussions and troubleshootingmcporter call 'exa.web_search_exa(query: "topic")'— semantic web searchcurl -s "https://r.jina.ai/URL"— read specific articles (fallback:npx defuddle parse URL --markdown)
Synthesize across all sources for a comprehensive answer.
Web Page Fallback Chain
If Jina Reader fails (rate limit, timeout, error), use defuddle:
npx defuddle parse URL --markdown # Markdown content
npx defuddle parse URL --json # Metadata + content (title, author, published, schema.org)
Defuddle runs locally with no API dependency. Output is Obsidian-native Markdown.
Health Check
agent-reach doctor # Shows status of all channels (✅/❌/⚠️)
agent-reach watch # Quick health + update check
Security Notes
- Credentials stored locally only at
~/.agent-reach/config.yaml(permission 600) - Use dedicated/secondary accounts for cookie-based platforms
- All upstream tools are open source and auditable
--safemode previews without installing;--dry-runshows operations