agent-reach

Files (3)

• SKILL.md
• xiaohongshu-login-linux-amd64 · scripts/
• xiaohongshu-mcp-linux-amd64 · scripts/

SKILL.md (first lines)

### 小红书前置操作
当用户提到小红书的时候，环境已经配置完成，因此请按照以下步骤执行，且每个步骤最多执行一次：

step 1: 使用```ps aux | grep xiaohongshu-mcp```命令检查mcp服务是否在后台运行，如果这个mcp服务已经在后台运行的话就执行step 4；如果没有运行的话就按顺序执行接下来的步骤。

step 2 :
```
nohup {baseDir}/scripts/xiaohongshu-mcp-linux-amd64 -headless=false -bin /usr/bin/google-chrome > /tmp/xiaohongshu-mcp.log 2>&1 &
```

step 3 :
```
mcporter config add xiaohongshu http://localhost:18060/mcp
```

step 4：该任务完成

### 登录小红书 / login xiaohongshu
当用户需要登录小红书的时候
执行```{baseDir}/scripts/xiaohongshu-login-linux-amd64 -bin /usr/bin/google-chrome```这个可执行文件来进行登录，绝对不要使用xiaohongshu.get_login_qrcode()这个mcp的tool。

### 小红书 / XiaoHongShu (mcporter + xiaohongshu-mcp)
示例，具体tool查看xiaohongshu-mcp
```bash
# Check login status 
mcporter call 'xiaohongshu.check_login_status()'

# 登出或者退出小红书
mcporter call 'xiaohongshu.delete_cookies()'

# Search notes
mcporter call 'xiaohongshu.search_feeds(keyword: "query")'

# Read a note
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy")'

# Get comments
mcporter call 'xiaohongshu.get_feed_comments(feed_id: "xxx", xsec_token: "yyy")'

# Post a note 
mcporter call xiaohongshu.publish_content title="标题" content="内容" images='["/path/to/img.jpg"]'
# or
mcporter call 'xiaohongshu.publish_content(title: "标题", content: "内容", images: ["/path/to/img.jpg"])'

# 点赞
mcporter call 'xiaohongshu.like_feed(feed_id: "xxx", xsec_token: "yyy")'

# 评论
mcporter call 'xiaohongshu.post_comment_to_feed(content: "内容", feed_id: "xxx", xsec_token: "yyy")'

# 收藏
mcporter call 'xiaohongshu.favorite_feed(feed_id: "xxx", xsec_token: "yyy")'
```

# Agent Reach

Install and configure upstream tools for 12+ platforms. After setup, call them directly — no wrapper layer.

## Setup

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

`install` auto-detects your environment and installs core dependencies (Node.js, mcporter, xreach CLI, gh CLI, yt-dlp, feedparser). Run `doctor` to see what's active.

## Management

```bash
agent-reach doctor        # channel status overview
agent-reach watch         # quick health + update check
agent-reach check-update  # check for new versions
```

## Configure channels

```bash
agent-reach configure twitter-cookies "auth_token=xxx; ct0=yyy"
agent-reach configure proxy http://user:pass@ip:port
agent-reach configure --from-browser chrome    # auto-extract cookies from local browser
```

## Configuring a channel ("帮我配 XXX")

When a user asks to configure/enable any channel:

1. Run `agent-reach doctor`
2. Find the channel — it shows status (✅/⚠️/⬜) and **what to do next**
3. Execute what you can automatically (install packages, start services)
4. For human-required steps (paste cookies), tell the user what to do
5. Run `agent-reach doctor` again to verify

**Do NOT memorize per-channel steps.** Always rely on `doctor` output.

### Other human actions

- **Proxy:** Reddit/Bilibili/XiaoHongShu may block server IPs — suggest a residential proxy if on a server

---

## Using Upstream Tools Directly

After `agent-reach install`, call the upstream tools directly. No need for `agent-reach read` or `agent-reach search`.

### Twitter/X (xreach CLI)

```bash
# Search tweets
xreach search "query" --json -n 10

# Read a specific tweet
xreach tweet https://x.com/user/status/123 --json

# Read a user's timeline
xreach tweets @username --json -n 20
```

From zhaoxinyi02/ClawPanel-Plugins, MIT.

More from zhaoxinyi02/ClawPanel-Plugins