Agent skill

Agent Reach

by Panniantong in Panniantong/Agent-Reach

Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

MITAuto-check passedProductivity & Automation

SKILL.md written in Chinese; this summary is our English description.

Install Agent Reach

skills CLI
$ npx skills add Panniantong/Agent-Reach --skill agent-reach -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Panniantong/Agent-Reach agent-reach --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Panniantong/Agent-Reach.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent_reach/skill .claude/skills/agent-reach && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agent-reach
GitHub stars
95k
Token cost
~1.4k tokens
SKILL.md length
265 words
Files
9 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

  • Works in 5 steps: 动手前先体检:多后端/登录态平台(小红书/Reddit/B站/Twitter/Fa… → 声明你在用什么:开始干活前说一句「使用 agent-reach 的 X 平台 /… → 失败按 references 里的重试链处理,不要瞎猜命令。 → …
  • Researching what people say about a product across several platforms
  • SKILL.md covers 常驻规则(全程适用), 路由表, 零配置快速命令 and 需登录态的平台(按 doctor 的…, plus 5 more sections
  • Calls curl, gh and yt-dlp; reaches r.jina.ai and v2ex.com; needs TWITTER_AUTH_TOKEN

What it does

Agent Reach is a routing layer for reading the internet. When you ask the agent to research a topic, look something up or open a link from a supported platform, the skill points it to the right backend: Exa web search, per-platform CLIs or APIs for social sites, career sites such as LinkedIn and Boss, GitHub code search, articles and RSS feeds, video subtitles and stock quotes. Detailed commands live in reference files for each category.

Its standing rules ask the agent to run agent-reach doctor before using platforms that need a login, say which backend it is using, follow the documented retry chains on failure and combine several platforms for broad research. Logins stay under your control: it does not sign in for you or read browser cookies, and secrets are passed only through the environment. It only fetches content, so writing reports, posting or commenting are out of scope. The SKILL.md is written mainly in Chinese.

When your agent uses it

  • Researching what people say about a product across several platforms
  • Reading a post or thread from a shared social media link
  • Pulling video subtitles or stock quotes for a topic

Example prompts

  • “Research how developers are reacting to the new Bun release.”
  • “What are people on Xiaohongshu saying about this skincare brand?”
  • “Get the transcript of this Bilibili video and list its main points.”

Requirements

  • The agent-reach CLI
  • Your own logged-in sessions for platforms that need them

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 动手前先体检:多后端/登录态平台(小红书/Reddit/B站/Twitter/Facebook/Instagram/Boss直聘)先跑
  2. 声明你在用什么:开始干活前说一句「使用 agent-reach 的 X 平台 / Y 后端」。
  3. 失败按 references 里的重试链处理,不要瞎猜命令。
  4. 全网调研类任务:组合多平台(Exa 搜索 + Twitter/Reddit 看讨论 + 小红书/B站看中文场景),并行收集再汇总。
  5. 替用户盯版本:完成一次较大的调研/多平台任务后,顺手跑

What it can do on your machine

Read from SKILL.md and the folder at commit 94f06c1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • gh
    • yt-dlp

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • r.jina.ai
    • v2ex.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TWITTER_AUTH_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agent Reach loads about 1.4k tokens when it runs, and up to ~9k if it reads all its reference files. Until then it costs about 233 tokens; SKILL.md has 265 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~233
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Panniantong/Agent-Reach at commit 94f06c1, republished under its MIT licence (© Panniantong). 265 words, ~1,418 tokens.

Download SKILL.mdSave it as .claude/skills/agent-reach/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
agent-reach
description
MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X / 看看大家怎么评价 X / X 上有什么讨论 / research this topic。 Also MUST USE when user mentions any platform or shares any URL/链接: 小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, Facebook, Instagram, V2EX, LinkedIn/领英/Boss直聘/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客, 雪球/股票行情, RSS feeds, or any web URL. 16 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs). Zero config for 6 channels. Run `agent-reach doctor --json` to see which backend serves each platform right now. NOT for: 写报告/数据分析/翻译等内容加工(本 skill 只负责从互联网获取内容); 发帖/评论/点赞等写操作;已有专门 skill 的平台(先用专门 skill)。 【路由方式】SKILL.md 包含路由表和常用命令,复杂场景需按需阅读对应分类的 references/*.md。 分类:search / social (小红书/推特/B站/V2EX/Reddit/Facebook/Instagram) / career(LinkedIn/Boss直聘) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客) / finance(雪球/股票)。
metadata.homepage
https://github.com/Panniantong/Agent-Reach

Agent Reach — 互联网能力路由器

16 平台、多后端。本 skill 存在时必须用它访问这些平台,不要自己发明方案。

常驻规则(全程适用)

  1. 动手前先体检:多后端/登录态平台(小红书/Reddit/B站/Twitter/Facebook/Instagram/Boss直聘)先跑 agent-reach doctor --json。active_backend 有值时按它选命令组;active_backend: null 表示 Doctor 为避免触发浏览器 Cookie 读取或远端写入而没有做实时验证,不代表后端不存在。 Doctor 结果是「某一时刻的快照」,通道/登录态可能已变化;执行只读命令前若怀疑失效, 按对应 reference 的「体检与恢复」runbook 重新确认(如 career.md 的 Boss直聘 CDP 排查)。
  2. 声明你在用什么:开始干活前说一句「使用 agent-reach 的 X 平台 / Y 后端」。
  3. 失败按 references 里的重试链处理,不要瞎猜命令。
  4. 全网调研类任务:组合多平台(Exa 搜索 + Twitter/Reddit 看讨论 + 小红书/B站看中文场景),并行收集再汇总。
  5. 替用户盯版本:完成一次较大的调研/多平台任务后,顺手跑 agent-reach check-update(很快,一个 API 调用)。有新版就在收尾汇报里附一句: 「Agent Reach 有新版 vX.Y.Z,复制这句话给我即可更新:帮我更新 Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。 不要中断当前任务去更新,也不要重复提醒同一个版本。

路由表

用户意图分类详细文档
网页搜索/代码搜索searchreferences/search.md
小红书/推特/B站/V2EX/Reddit/Facebook/Instagramsocialreferences/social.md
招聘/职位/LinkedIn/Boss直聘careerreferences/career.md
GitHub/代码devreferences/dev.md
网页/文章/RSSwebreferences/web.md
YouTube/B站/播客字幕videoreferences/video.md
雪球/股票行情financereferences/finance.md

零配置快速命令

bash
# Exa 网页搜索
mcporter call exa.web_search_exa query="query" numResults=5

# 通用网页阅读
curl -s "https://r.jina.ai/URL"

# GitHub 搜索
gh search repos "query" --sort stars --limit 10

# YouTube 字幕(注意:B站不要用 yt-dlp,失败重试链见 video.md)
yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL"

# V2EX 热门
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"

# B站搜索(bili-cli,无需登录)
bili search "query" --type video -n 5

需登录态的平台(按 doctor 的 active_backend 选命令)

Twitter 注意:agent-reach configure twitter-cookies 保存的 Cookie 只供 doctor 检查配置是否齐全;doctor 不执行 twitter status,也不会设置当前 Shell。直接运行 twitter 前,必须在子进程环境中显式提供 TWITTER_AUTH_TOKEN 和 TWITTER_CT0,不得在日志或命令回显中暴露值。

小红书注意:Agent Reach 不替用户登录,也不读取浏览器 Cookie。OpenCLI 只用 用户已有且明确控制的 Chrome 会话;没有现成会话时不要自动登录,改用 Cookie-Editor 手工导出后配置 xiaohongshu-mcp / 存量工具。

Boss直聘配置触发:当用户说“帮我配 Boss直聘”时,先读取 references/career.md 的 Boss 章节,然后在获得安装授权后运行 agent-reach install --env=local --system --channels=boss。Agent 负责按系统启动 只绑定 127.0.0.1:9222 的专用 Chrome;拉起后第一步是暂停并让用户肉眼确认 窗口内是已登录状态(右上角有头像),未登录则让用户登录/扫码,用户确认后再运行 boss --cdp-url http://localhost:9222 login --cdp 和 agent-reach doctor 验收。 不要让用户自己研究端口参数。 专用 Chrome profile 必须长期复用,不要每次创建,也不要默认改用日常主 Chrome。

判断 CDP 浏览器登录态不要信 boss status(它只校验本地 session.enc,与 浏览器登录态互不代表),以 agent-reach doctor 的浏览器 cookie 探测(wt2) 为准,并配合用户肉眼确认。绝不用当前页 URL 判断登录态: security-check / zhipin-security / _security_check 安全校验页是 Boss 反爬挑战, 与登录无关——已登录也会出现(带 CDP 调试端口的 Chrome 几乎必现)。看到它不要 当成“未登录”,先跑 agent-reach doctor 看浏览器 cookie,再决定是否需要用户登录。 搜索报 AUTH_EXPIRED 即浏览器未登录的 ground truth:直接走登录流程 + login --cdp, 不要往安全校验方向解释。

执行搜索时必须使用 boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...; 遇到 ENVIRONMENT_RISK 立即停止,不刷新、不重新登录、不自动重试。

bash
# Twitter 搜索(twitter-cli 首选;失败重试链见 social.md)
twitter search "query" -n 10

# Reddit(无零配置路径:OpenCLI 或 rdt-cli,必须登录态)
opencli reddit search "query" -f yaml   # 桌面
rdt search "query" --limit 10            # 存量/服务器

# 小红书(桌面首选 OpenCLI)
opencli xiaohongshu search "query" -f yaml

# Facebook / Instagram(桌面 OpenCLI,复用浏览器登录态)
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml       # 搜用户
opencli instagram user USERNAME -f yaml        # 读指定用户最近帖子

环境检查

bash
# 检查可用 channel 与每个平台当前激活的后端
agent-reach doctor --json

OpenCLI 适配器发现

路由表没有覆盖用户需要的平台或命令时,先用 opencli list 查已有适配器,再用 opencli <平台> --help 查看公开命令。发现适配器只证明命令存在,不证明登录态或 目标内容可用;仅在用户任务明确需要该平台时执行只读命令,并以实际非空内容验收。

工作区规则

不要在 agent workspace 创建文件。 使用 /tmp/ 存放临时输出,~/.agent-reach/ 存放持久数据。

详细文档

根据用户需求,阅读对应的详细文档:

配置渠道

如果某个 channel 需要配置,获取安装指南: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

用户只需提供 cookies,其他配置由 agent 完成。

© Panniantong, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (references) in agent_reach/skill of Panniantong/Agent-Reach.

  • SKILL.md
  • SKILL_en.md
  • references/career.md
  • references/dev.md
  • references/finance.md
  • references/search.md
  • references/social.md
  • references/video.md
  • references/web.md

Open the folder on GitHubat commit 94f06c1

Compare with similar skills

Agent Reach next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agent Reach compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Reach this skillPanniantong/Agent-Reach95k—~1.4kAutomated safety check: PassMIT
bb-browser Site Commands for OpenClawepiral/bb-browser6.2k—~1kAutomated safety check: PassMIT
Deepapidavidondrej/skills4.1k—~2.5kAutomated safety check: PassMIT
Funding Signal Monitorgooseworks-ai/goose-skills1.2k1 repos~2.3kAutomated safety check: PassMIT
Trending Ad Hook Spottergooseworks-ai/goose-skills1.2k1 repos~2.5kAutomated safety check: PassMIT
Competitor Intelgooseworks-ai/goose-skills1.2k1 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Runs structured data commands against sites such as Twitter, Reddit, GitHub, YouTube and Zhihu through OpenClaw's browser, reusing your existing login state.

    6.2k GitHub stars~1k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Deepapi

    davidondrej/skills

    Use DeepAPI for all web search, deep research, and web scraping (websites, LinkedIn, GitHub, X/Twitter, YouTube, Instagram) instead of built-in search, research, fetch, or browser tools.

    4.1k GitHub stars~2.5k tokensUpdated 2 days ago
    Data & AnalyticsAuto-check passed
  • Funding Signal Monitor

    gooseworks-ai/goose-skills

    Monitor web sources for Series A-C funding announcements. An agent skill from gooseworks-ai/goose-skills.

    1.2k GitHub starsUsed in 1 repo~2.3k tokens
    Productivity & AutomationAuto-check passed
  • Trending Ad Hook Spotter

    gooseworks-ai/goose-skills

    Monitor Twitter/X, Reddit, LinkedIn, and Hacker News for trending narratives, viral posts, and hot-button topics in your space.

    1.2k GitHub starsUsed in 1 repo~2.5k tokens
    Productivity & AutomationAuto-check passed
  • Competitor Intel

    gooseworks-ai/goose-skills

    Competitor intelligence system. An agent skill from gooseworks-ai/goose-skills.

    1.2k GitHub starsUsed in 1 repo~1.8k tokens
    Marketing & SEOAuto-check passed
  • Agent Reach

    EdisonChenAI/agent-reach

    Use the internet: search, read, and interact with 13+ platforms including Twitter/X, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu (小红书), Douyin (抖音), WeChat Articles (微信公众号), LinkedIn, Boss直聘…

    115 GitHub starsUsed in 1 repo~1.3k tokens
    Productivity & AutomationAuto-check passed

Questions about Agent Reach

What does Agent Reach do?

Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool. Agent Reach is a routing layer for reading the internet. When you ask the agent to research a topic, look something up or open a link from a supported platform, the skill points it to the right backend: Exa web search, per-platform CLIs or APIs for social sites, career sites such as LinkedIn and Boss, GitHub code search, articles and RSS feeds, video subtitles and stock quotes.

When should I use Agent Reach?

Agent Reach fits situations like: researching what people say about a product across several platforms; reading a post or thread from a shared social media link; pulling video subtitles or stock quotes for a topic.

How do I install Agent Reach in Claude Code?

Run `npx skills add Panniantong/Agent-Reach --skill agent-reach -a claude-code`. Or copy the skill folder (agent_reach/skill in Panniantong/Agent-Reach) into .claude/skills/agent-reach in your project. Claude Code loads it when a task matches its description.

How do I install Agent Reach in Codex?

Run `npx skills add Panniantong/Agent-Reach --skill agent-reach -a codex`. Or copy the skill folder (agent_reach/skill in Panniantong/Agent-Reach) into .agents/skills/agent-reach in your project. Codex loads it when a task matches its description.

Can I use Agent Reach in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Panniantong/Agent-Reach --skill agent-reach -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-reach, .gemini/skills/agent-reach, .github/skills/agent-reach and .opencode/skills/agent-reach in your project.

What does Agent Reach need to run?

Going by SKILL.md and its folder, Agent Reach needs the command-line tools its instructions call (curl, gh and yt-dlp) and credentials named TWITTER_AUTH_TOKEN. Our summary lists: The agent-reach CLI; Your own logged-in sessions for platforms that need them.

Does Agent Reach access the network?

SKILL.md names 2 domains. In commands or code: r.jina.ai and v2ex.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Agent Reach safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agent Reach use?

Agent Reach is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Reach use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.6k tokens, read only when the agent opens those files.

What are the alternatives to Agent Reach?

Skills that share tags, products or a category with Agent Reach: bb-browser Site Commands for OpenClaw (epiral/bb-browser, 6.2k stars), Deepapi (davidondrej/skills, 4.1k stars), Funding Signal Monitor (gooseworks-ai/goose-skills, 1.2k stars) and Trending Ad Hook Spotter (gooseworks-ai/goose-skills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Reach?

Panniantong (a GitHub user) maintains it in Panniantong/Agent-Reach, which has 95,131 GitHub stars. The repository was last updated on October 8, 2026.

Source: Panniantong/Agent-Reach on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.