Agent-Reach/docs/install.md
Panniantong 51f73639e2 fix: install 自动安装 gh CLI + Node.js,加大 mcporter 超时
问题:新服务器上 gh CLI 和 Node.js 未安装,mcporter npm install 60s 超时
修复:
- 新增 _install_system_deps():自动安装 gh CLI (apt) + Node.js (nodesource)
- mcporter 超时从 60s → 120s
- install.md 更新:去掉过时的 exa-key/xhs-cookie 配置步骤
- install 流程:系统依赖 → mcporter → Exa 配置 → 环境检测 → 测试
2026-02-24 15:05:00 +01:00

2.2 KiB
Raw Blame History

Agent Reach — Installation Guide

For Humans

Copy this to your AI Agent:

帮我安装 Agent Reachhttps://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

For AI Agents

Step 1: Install

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:

  • Installs system dependencies (gh CLI, Node.js, mcporter) if missing
  • Configures Exa search (free, no API key needed)
  • Detects local computer vs server
  • Auto-imports browser cookies on local (Twitter)
  • 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 cookies were not auto-imported (server users):

"To unlock Twitter search and posting, install the Cookie-Editor Chrome extension, go to twitter.com, click Export → Header String, and paste it to me." Extension: https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm

agent-reach configure twitter-cookies "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."

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

Step 3: Verify

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 (installs deps + configures)
agent-reach doctor Show status
agent-reach configure twitter-cookies "..." Unlock Twitter search + posting
agent-reach configure proxy URL Unlock Reddit + Bilibili (server)
agent-reach read URL Read any URL
agent-reach search "query" Search the web