# Agent Reach — Installation Guide

## For Humans

Copy this to your AI Agent:

```
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
```

---

## For AI Agents

### Step 1: Install

```bash
pip install https://github.com/Panniantong/agent-reach/archive/main.zip || pip3 install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto
```

This single command does everything automatically:
- Detects local computer vs server
- Auto-imports browser cookies on local (Twitter, XiaoHongShu, Bilibili)
- Auto-detects Exa API key if already in environment
- Tests all channels
- Shows what's working and what needs setup

**Read the output carefully.** It tells you exactly what happened and what's next.

### Step 2: Only if needed — configure what's missing

Based on the install output, you may need to configure one or two things.
Only ask the user for items the install output says are missing.

**If search is not configured:**
> "Want to unlock web search? Go to https://exa.ai → sign up (free) → send me the API key."

```bash
agent-reach configure exa-key THE_KEY
```

**If cookies were not auto-imported (server users):**
> "To unlock Twitter and XiaoHongShu, install the Cookie-Editor Chrome extension, go to the site, click Export → Header String, and paste it to me."
> Extension: https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm

```bash
agent-reach configure twitter-cookies "PASTED_STRING"
agent-reach configure xhs-cookie "PASTED_STRING"
```

**If on server and wants Reddit/Bilibili full access:**
> "Reddit and Bilibili block server IPs. Get a proxy at https://webshare.io ($1/month) and send me the address."

```bash
agent-reach configure proxy http://user:pass@ip:port
```

### Step 3: Verify

```bash
agent-reach doctor
```

Report what's active. Users can configure more anytime by asking.

---

## Quick Reference

| Command | What it does |
|---------|-------------|
| `agent-reach install --env=auto` | Full auto-setup |
| `agent-reach doctor` | Show status |
| `agent-reach configure exa-key KEY` | Unlock search |
| `agent-reach configure twitter-cookies "..."` | Unlock Twitter |
| `agent-reach configure xhs-cookie "..."` | Unlock XiaoHongShu |
| `agent-reach configure proxy URL` | Unlock Reddit + Bilibili (server) |
| `agent-reach read URL` | Read any URL |
| `agent-reach search "query"` | Search the web |