{"owner":"Panniantong","repo":"Agent-Reach","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["CLAUDE.md","llms.txt"],"files":{"CLAUDE.md":"# CLAUDE.md\n\n## Project\nAgent Reach — Python CLI + library that gives AI agents read/search access to 13 internet platforms.\nPositioning: installer + doctor + config tool. NOT a wrapper — after install, agents call upstream tools directly.\nRepo: github.com/Panniantong/Agent-Reach | License: MIT | Version: 1.5.0\n\n## Commands\n- `pip install -e .` — Dev install\n- `pytest tests/ -v` — All tests\n- `pytest tests/test_cli.py -v` — CLI tests only\n- `bash test.sh` — Full integration test (creates venv, installs, runs doctor + channel tests)\n- `python -m agent_reach.cli doctor` — Run diagnostics\n- `python -m agent_reach.cli install --env=auto` — Auto-configure\n\n## Structure\n- `agent_reach/cli.py` — CLI entry point (argparse)\n- `agent_reach/core.py` — Core read/search routing logic\n- `agent_reach/config.py` — Config management (YAML, env vars)\n- `agent_reach/doctor.py` — Diagnostics engine\n- `agent_reach/channels/` — One file per platform (twitter.py, reddit.py, youtube.py, etc.)\n- `agent_reach/channels/base.py` — Base channel class (all channels inherit from this)\n- `agent_reach/integrations/mcp_server.py` — MCP server integration\n- `agent_reach/skill/` — OpenClaw skill files\n- `agent_reach/guides/` — Usage guides\n- `tests/` — pytest tests\n- `config/mcporter.json` — MCP tool config\n\n## Conventions\n- Python 3.10+ with type hints\n- Each channel is a single file in `channels/`, inherits from `BaseChannel`\n- Channel contract: must implement `can_handle(url)`, `read(url)`, `search(query)`, `check()` methods\n- Use `loguru` for logging, `rich` for CLI output\n- Commit format: `type(scope): message` (one commit = one thing)\n- All upstream tool calls go through public API/CLI, never hack internals\n\n## Rules\n- NEVER modify upstream open source projects' source code\n- Agent Reach is a \"glue layer\" — only route and call, don't reimagine\n- Version in THREE places must match: `pyproject.toml`, `__init__.py`, `tests/test_cli.py`\n- Always new branch for changes, PR to main, never push to main directly\n- Run `pytest tests/ -v` before committing — all tests must pass\n- Cookie-based auth (Twitter, XHS): use Cookie-Editor export method only, no QR scan\n- XHS login: Cookie-Editor browser export only (QR will hang)\n","llms.txt":"# Agent Reach\n\n> Give your AI agent eyes to see the internet. Agent Reach installs, routes, and health-checks upstream tools for 15 platforms — Twitter/X, Reddit, Facebook, Instagram, YouTube, GitHub, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Xiaoyuzhou Podcast, RSS, web search, and any web page. One install, zero API fees.\n\n## Quick Start\n\n- [Installation Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): Step-by-step setup instructions for AI agents\n- [README (中文)](https://github.com/Panniantong/Agent-Reach/blob/main/README.md): Full documentation in Chinese\n- [README (English)](https://github.com/Panniantong/Agent-Reach/blob/main/docs/README_en.md): Full documentation in English\n\n## Core Commands\n\n- [CLI Usage](https://github.com/Panniantong/Agent-Reach/blob/main/docs/install.md): `agent-reach doctor --json` shows the active backend; agents then call upstream tools directly (`opencli`, `twitter`, `bili`, `yt-dlp`, `gh`, `mcporter`, etc.).\n\n## Key Features\n\n- Read any URL: tweets, Reddit posts, Facebook pages/feed/groups, Instagram profiles/posts, YouTube videos (transcripts), GitHub repos, articles, XiaoHongShu notes, Bilibili videos, RSS feeds\n- Search/discover across platforms: Twitter/X, Reddit, Facebook, Instagram user search, GitHub, YouTube, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Web (via Exa)\n- Self-diagnosis: `agent-reach doctor` checks what works and what needs setup\n- Auto-installs dependencies: `agent-reach install --env=auto`\n- Browser-session / cookie auth for platforms that require login (Twitter, Reddit, Facebook, Instagram, XiaoHongShu, Xueqiu)\n- Proxy support for platforms that block server IPs (Reddit, Twitter)\n- Zero API fees: all backends are free and open-source (OpenCLI, twitter-cli, rdt-cli, bili-cli, yt-dlp, Jina Reader, mcporter/Exa, etc.)\n\n## Troubleshooting\n\n- [Troubleshooting Guide](https://github.com/Panniantong/Agent-Reach/blob/main/docs/troubleshooting.md): Common issues and solutions\n\n## Optional\n\n- [SKILL.md](https://github.com/Panniantong/Agent-Reach/blob/main/agent_reach/skill/SKILL.md): Integration guide for AI agent frameworks (OpenClaw, Claude Code, etc.)\n- [PyPI Package](https://pypi.org/project/agent-reach/): `pip install agent-reach`\n"}}