claudegoodies
CLAUDE.md

Agent-Reach CLAUDE.md

From Panniantong

Agent Reach — Python CLI + library that gives AI agents read/search access to 13 internet platforms.

Installs and diagnoses CLI/MCP config so AI agents call upstream tools to read/search 13 platforms.

Use it when

  • Need one CLI/MCP interface for agents to read/search Twitter, Reddit, YouTube, etc.
  • Want a doctor command to diagnose per-platform auth/config issues
  • Adding a new platform by writing a channel file that inherits BaseChannel
  • Need cookie-based auth setup for Twitter or XHS via Cookie-Editor export

Skip it if

  • Requires Python 3.10+
  • It's a glue/routing layer, not a replacement for the underlying platform APIs
  • XHS/Twitter login only works via manual Cookie-Editor export, QR scan unsupported

Facts

Repository
Panniantong/Agent-Reach
Status
Actively maintained
Last commit
Source file
CLAUDE.md

Source preview

The instructions Claude Code reads when this claude.md runs.

# CLAUDE.md

## Project
Agent Reach — Python CLI + library that gives AI agents read/search access to 13 internet platforms.
Positioning: installer + doctor + config tool. NOT a wrapper — after install, agents call upstream tools directly.
Repo: github.com/Panniantong/Agent-Reach | License: MIT | Version: 1.5.0

## Commands
- `pip install -e .` — Dev install
- `pytest tests/ -v` — All tests
- `pytest tests/test_cli.py -v` — CLI tests only
- `bash test.sh` — Full integration test (creates venv, installs, runs doctor + channel tests)
- `python -m agent_reach.cli doctor` — Run diagnostics
- `python -m agent_reach.cli install --env=auto` — Auto-configure

## Structure
- `agent_reach/cli.py` — CLI entry point (argparse)
- `agent_reach/core.py` — Core read/search routing logic
- `agent_reach/config.py` — Config management (YAML, env vars)
- `agent_reach/doctor.py` — Diagnostics engine
- `agent_reach/channels/` — One file per platform (twitter.py, reddit.py, youtube.py, etc.)
- `agent_reach/channels/base.py` — Base channel class (all channels inherit from this)
- `agent_reach/integrations/mcp_server.py` — MCP server integration
- `agent_reach/skill/` — OpenClaw skill files
- `agent_reach/guides/` — Usage guides
- `tests/` — pytest tests
- `config/mcporter.json` — MCP tool config

## Conventions
- Python 3.10+ with type hints
- Each channel is a single file in `channels/`, inherits fro
View full source on GitHub →

Other claude.md files