Agent Reach: a skill that lets Claude read Xiaohongshu, Bilibili, Reddit, X and other sites it cannot reach

Agent Reach adds an agent-reach command so Claude can search and read sites it cannot open itself, such as Xiaohongshu, Bilibili, Reddit and X.

Installs: 21.5K; on skills.sh
Stars: 107.6K; on GitHub
Files: 4; besides SKILL.md
Updated: Nov 2026; last repo commit

The skill teaches Claude to use the agent-reach command for sites its own search and page reading cannot handle. It covers 14 channels: Bilibili, V2EX, GitHub, YouTube, a general web channel, Xiaohongshu, Xueqiu, Boss, Xiaoyuzhou, LinkedIn, Reddit, X/Twitter, Facebook and Instagram. Results come back as one line of JSON with title, URL, author, date and text.

SKILL.md says Claude should first try its own tools for public content and reach for Agent Reach only when those fail or return too little. It says the skill is read-only: no posting, commenting, liking or messaging. It never logs in for you or asks for a password. When a site needs login, Claude opens a dedicated browser window and you sign in yourself.

This skill is not a plain folder you copy. The README installs a command-line program with uv, and agent-reach setup turns on the default channels and installs the skill. The program then adds tools for each platform. Read the permissions section before you run it.

Good for

Researchers who need posts, comments and captions from Chinese and global platforms
Developers who want V2EX threads, GitHub issues or Xueqiu quotes in clean JSON
Job seekers and recruiters reading Boss and LinkedIn listings through Claude

Install agent-reach

Claude Code

Copy this prompt.

Install the agent-reach skill in Claude Code. Run this command:

uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip
agent-reach setup

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires uv.

Do not install the PyPI package named agent-reach. It is a different project. agent-reach setup turns on the default channels and installs the agent skill. For another AI tool, agent-reach skill link <skill folder> adds the skill there.

From the vendor's docs. Source.

What's in the skill

When it loads

只读读取各平台内容：搜索、读帖、看评论、取字幕、查行情和职位。 Use when 用户提到或贴出链接：小红书/xiaohongshu、B站/bilibili、Twitter/X、Reddit、 YouTube（字幕、转录）、GitHub、V2EX、雪球/股票行情、LinkedIn/Boss直聘职位、 Instagram、Facebook、小宇宙播客；或说"帮我搜/看看/读一下这个链接"而自带网页搜索/读取不可用、失败或拿不到正文；或要安装、加上/去掉某个平台、登录/退出、看状态、更新、卸载 Agent Reach。不做：发帖、评论、点赞、私信等任何写操作；不替用户登录、不索要密码。公开内容优先用 Agent 自带工具，Reach 补缺口。

Sections in SKILL.md

选路
结果与错误
登录与专用浏览器
平台注意
渠道
安装完成时
用户要管理 Agent Reach 时
有新版本时
红线

Key facts

Author: Panniantong
License: MIT
Repository: panniantong/agent-reach
Installs on skills.sh: 21,516 as of 2026-11-02
GitHub stars: 107,559 as of 2026-11-02
Last repo commit: 2026-11-01
Files in the skill folder: 5 files including SKILL.md (SKILL_en.md and 3 reference guides)
skills.sh audits: Gen Agent Trust Hub warn, Socket warn, Snyk warn
Skill file language: SKILL.md is in Chinese, with SKILL_en.md alongside it
Needs: uv (installed for you if missing); some channels need a login or a Groq or OpenAI key
Works with: The README says any agent, and names Claude Code, Codex, Hermes Agent and OpenClaw

What it includes

Lists every channel and its actions
The first command to run when Claude is unsure which actions and parameters exist.
Runs code · agent-reach channels
Search or read on one platform
For example `agent-reach xiaohongshu search "咖啡" --limit 5`. Output is JSON with ok, items and raw.
Runs code · agent-reach <channel> <action>
Picks the channel from the link
Reads a post, video page or listing by URL.
Runs code · agent-reach read <link>
Bilibili, V2EX, GitHub, YouTube, web
On after setup. Bilibili captions need a QR login, and YouTube speech-to-text needs a Groq or OpenAI key.
Network · Default channels
Xiaohongshu, Xueqiu, Boss, Xiaoyuzhou, LinkedIn, Reddit
Added on request with `agent-reach add <channel>`, which installs what the channel needs. Most need a login. Xiaoyuzhou needs a Groq key.
Runs code · Optional channels
X/Twitter, Facebook, Instagram
The README says they work but can break at any time because of anti-bot measures. All need a login.
Network · Experimental channels
Manage channels and sessions
`login` opens a dedicated browser window for you to sign in. `logout` and `remove` clear that site's login.
Runs code · add / remove / login / logout
Status, live tests, upgrade and removal
`doctor --text` reads local state. `check` tests over the network. `update` and `uninstall` are run only after you agree, and uninstall shows a dry run first.
Runs code · doctor / check / update / uninstall
Stores a key or proxy
Keys are groq-key, openai-key, proxy and github-token, entered by you in your own terminal.
Runs code · configure
What Claude does on failure
NEED_SETUP, NEED_LOGIN, UPSTREAM_BROKEN, TIMEOUT, RATE_LIMITED, PLATFORM_BLOCKED, BUSY, NOT_FOUND and BAD_INPUT each have a defined next step. On a block or rate limit Claude stops instead of retrying.
Error codes

From the official docs

Permissions

High risk

Agent Reach installs programs on your computer and can reuse a site login from your Chrome in its own browser. Use a secondary account for logins, and review what the install report lists before you continue.

What it can do

Read your data
Create and change things
Delete things
Read-only modeHow to turn it on

Watch out for

Installs a program and many third-party tools
The install runs `uv tool install` on a zip from GitHub releases, then setup. Adding a channel installs more tools such as OpenCLI, a browser and extensions. Review what the install report lists, and install only on a machine you are comfortable with.
Copies a site's login from your Chrome
On first use of a site, and only if the OpenCLI extension is connected to your Chrome, it copies that site's cookies into a dedicated browser. The README says this is usually your main account and suggests a secondary account instead.
The uv installer may be piped to a shell
If uv is missing, install.md runs a curl command from astral.sh piped to sh on macOS and Linux, and a PowerShell script on Windows. Install uv yourself first if you prefer.
Audio and keys can go to Groq or OpenAI
Speech-to-text for YouTube and Xiaoyuzhou needs a Groq or OpenAI key. Do not paste keys into chat; use `agent-reach configure` in your terminal.
Platforms may limit automated accounts
The README warns that platforms can restrict accounts used for automated access. The skill tells Claude to stop on rate limits and blocks instead of retrying.

Technical details

Turning on read-only	SKILL.md states the skill is read-only and never posts, comments, likes or messages.
Talks to	The platforms you read from. The README's example for web reading: Jina Reader first, then Exa. GitHub releases for the install zip and astral.sh for uv. Groq or OpenAI if you configure a key for speech-to-text
Sign-in and keys	Settings, logins and tools live under ~/.agent-reach. Keys are set with `agent-reach configure` in your own terminal.
Scopes	Logins to platforms you choose, in a dedicated browser profile Optional Groq, OpenAI and GitHub keys

Questions

What does Agent Reach do?

It gives Claude one command, agent-reach, to search and read sites that Claude's own web tools cannot open, such as Xiaohongshu, Bilibili, Reddit, X, YouTube captions and V2EX. It returns JSON, and SKILL.md says it only reads and never posts.

How do I install it in Claude Code, the Claude app or Codex?

Use the install box above, which follows the README's route. Agent Reach is a command-line program, and the README does not describe a Claude app upload. It says it works with any agent and names Claude Code and Codex. It also warns that the PyPI package called agent-reach is not this project, so do not install it from PyPI.

Does it need an API key?

Not for the default channels. The README says YouTube speech-to-text needs a Groq or OpenAI key, Xiaoyuzhou transcription needs a Groq key, and several channels need a login. Keys are entered by you with agent-reach configure, not in chat.

Is it safe to install?

It installs a program and tools for each platform on your computer. It runs a dedicated browser, may copy the login for one site from your Chrome into it, and keeps everything under ~/.agent-reach. SKILL.md says it only reads and never logs in for you. The README suggests using a secondary account for logins.

Does it touch my main browser or accounts?

The README says login-required channels use Agent Reach's own browser profile, run headless in the background, and leave your normal browser unchanged. On first use of a site, it copies that one site's login from Chrome if the OpenCLI extension is connected. The README says the copied login is usually your main account.

Why does Claude not use it for a plain web search?

SKILL.md tells Claude to use its own search and page tools first for public content. It uses Agent Reach when those are unavailable, fail or miss the post text, comments or captions you asked for.

Why can the same skill folder not be copied like other skills?

The folder in the repo holds placeholders such as {{CHANNEL_TABLE}}. The install guide says agent-reach setup installs the agent skill, so use that route rather than copying the folder yourself.

How do I remove it?

Ask Claude to uninstall Agent Reach. SKILL.md says it first runs agent-reach uninstall --dry-run to show what will go, and only removes Agent Reach's own files after you confirm.

Information

updated Nov 2, 2026

Repository: panniantong/agent-reach
Folder: agent_reach/skill

panniantong/agent-reach skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

install.md · github.com
Agent-Reach README · github.com
SKILL.md · github.com
sessions.md · github.com
maintenance.md · github.com
capabilities.md · github.com