# Agent Atlas

> Search and research the open web for your AI agent. Agent Atlas installs, health-checks, and routes free upstream tools across 10 Western channels. It is not a scraper — after install, agents call upstream CLIs directly (Jina, Exa/mcporter, yt-dlp, gh, twitter-cli, rdt-cli, OpenCLI, feedparser).

## Quick Start

- Install: `uv tool install agent-atlas-cli` (CLI binary: `agent-atlas`; fallback: git+https://github.com/batu3384/agent-atlas.git)
- Agent one-liner: https://raw.githubusercontent.com/batu3384/agent-atlas/main/docs/install.md
- Update: https://raw.githubusercontent.com/batu3384/agent-atlas/main/docs/update.md
- Troubleshoot: https://raw.githubusercontent.com/batu3384/agent-atlas/main/docs/troubleshooting.md
- [Türkçe](https://github.com/batu3384/agent-atlas/blob/main/docs/README_tr.md)

## Core Commands

- `agent-atlas doctor --json` — channel status + `active_backend`
- `agent-atlas smoke` — one real research call per ready channel
- `agent-atlas watch` — quick health + update hint
- `agent-atlas check-update`
- `agent-atlas install` / `install --channels twitter,reddit,linkedin,opencli`

## Key Features

- Web (Jina), Exa search, YouTube (yt-dlp), GitHub (gh), RSS (feedparser)
- Twitter: twitter-cli → OpenCLI
- Reddit: rdt-cli (Chrome closed) → OpenCLI
- LinkedIn: linkedin-mcp → Jina (Reach-style; mcporter/Cursor probe → doctor **ok**)
- Facebook / Instagram: OpenCLI (often `disabled_channels`)
- Config → runtime env; Reddit cookie sync from Atlas Chrome profile
- Western-only by design (no Bilibili / Xiaohongshu / etc.)

## Optional

- [SKILL.md](https://github.com/batu3384/agent-atlas/blob/main/SKILL.md)
- [Platforms](https://github.com/batu3384/agent-atlas/blob/main/docs/platforms.md)
