agent-reach

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:

1. twitter search "topic" -n 10 — real-time discussion and sentiment
2. yt-dlp --dump-json URL — deep-dive video transcripts
3. gh search repos "topic" --sort stars — implementations and tools
4. rdt search "topic" — community discussions and troubleshooting
5. mcporter call 'exa.web_search_exa(query: "topic")' — semantic web search
6. curl -s "https://r.jina.ai/URL" — read specific articles (fallback: npx defuddle parse URL --markdown)

Username OSINT (handle → platforms)

When the task is "where does this username exist?" rather than "what are people saying?", use Sherlock:

pipx install sherlock-project
sherlock handle --csv

400+ sites. Complements Twitter/GitHub search in agent-reach. See [[sherlock]] in wiki.

Synthesize across all sources for an answer that covers the evidence.

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
• --safe mode previews without installing; --dry-run shows operations

Folded Skill References

These former standalone skills are bundled here as references to keep the runtime list compact. Load only the reference that matches the user's exact product, framework, or failure mode.