Pnant
5d046ecb61
Reddit blocks nearly all non-browser access at IP level (including ISP proxies). Switch Reddit channel to use Exa exclusively: - Search: web_search_exa with includeDomains: ["reddit.com"] - Read: crawling_exa for full post + comments - check() now verifies Exa availability instead of probing Reddit API - tier changed from 1 (needs config) to 0 (zero config) - Removed reddit_proxy from config, CLI, and setup guide - Updated all docs (README, README_en, install.md, SKILL.md, references) - Fixed xreach→bird references in references/social.md Fixes #218, Fixes #222, Fixes #221 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
155 lines
3.9 KiB
Markdown
155 lines
3.9 KiB
Markdown
# 社交媒体 & 社区
|
||
|
||
小红书、抖音、Twitter/X、微博、B站、V2EX、Reddit。
|
||
|
||
## 小红书 / XiaoHongShu
|
||
|
||
```bash
|
||
# 搜索笔记
|
||
mcporter call 'xiaohongshu.search_feeds(keyword: "query")'
|
||
|
||
# 获取笔记详情
|
||
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy")'
|
||
|
||
# 获取笔记详情 + 评论
|
||
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy", load_all_comments: true)'
|
||
|
||
# 发布内容
|
||
mcporter call 'xiaohongshu.publish_content(title: "标题", content: "正文", images: ["/path/img.jpg"], tags: ["tag"])'
|
||
```
|
||
|
||
> **需要登录**: 使用 Cookie-Editor 浏览器插件导出 cookies。运行 `agent-reach doctor` 检查状态。
|
||
|
||
## 抖音 / Douyin
|
||
|
||
```bash
|
||
# 解析视频信息
|
||
mcporter call 'douyin.parse_douyin_video_info(share_link: "https://v.douyin.com/xxx/")'
|
||
|
||
# 获取无水印下载链接
|
||
mcporter call 'douyin.get_douyin_download_link(share_link: "https://v.douyin.com/xxx/")'
|
||
|
||
# 提取视频文案
|
||
mcporter call 'douyin.extract_douyin_text(share_link: "https://v.douyin.com/xxx/")'
|
||
```
|
||
|
||
> **无需登录**
|
||
|
||
## Twitter/X (bird CLI)
|
||
|
||
```bash
|
||
# 搜索推文
|
||
bird search "query" -n 10
|
||
|
||
# 读取单条推文 (支持 /status/ 和 /article/ URL)
|
||
bird read URL_OR_ID
|
||
|
||
# 用户时间线
|
||
bird user-tweets @username -n 20
|
||
|
||
# 读取完整 thread
|
||
bird thread URL_OR_ID
|
||
```
|
||
|
||
> **需要配置**: `agent-reach configure twitter-auth ...` 或通过环境变量配置。
|
||
|
||
## 微博 / Weibo
|
||
|
||
```bash
|
||
# 使用 Jina Reader 读取
|
||
curl -s "https://r.jina.ai/https://weibo.com/USER_ID/POST_ID"
|
||
```
|
||
|
||
> 微博主要通过网页抓取，推荐使用通用网页读取方式。
|
||
|
||
## B站 / Bilibili
|
||
|
||
```bash
|
||
# 获取视频元数据
|
||
yt-dlp --dump-json "https://www.bilibili.com/video/BVxxx"
|
||
|
||
# 下载字幕
|
||
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --convert-subs vtt --skip-download -o "/tmp/%(id)s" "URL"
|
||
```
|
||
|
||
> **注意**: 服务器 IP 可能遇到 412 错误。使用 `--cookies-from-browser chrome` 或配置代理。
|
||
|
||
## V2EX (公开 API)
|
||
|
||
无需认证，直接调用公开 API。
|
||
|
||
### 热门主题
|
||
|
||
```bash
|
||
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
|
||
```
|
||
|
||
### 节点主题
|
||
|
||
```bash
|
||
# node_name 如: python, tech, jobs, qna, programmers
|
||
curl -s "https://www.v2ex.com/api/topics/show.json?node_name=python&page=1" -H "User-Agent: agent-reach/1.0"
|
||
```
|
||
|
||
### 主题详情
|
||
|
||
```bash
|
||
# topic_id 从 URL 获取，如 https://www.v2ex.com/t/1234567
|
||
curl -s "https://www.v2ex.com/api/topics/show.json?id=TOPIC_ID" -H "User-Agent: agent-reach/1.0"
|
||
```
|
||
|
||
### 主题回复
|
||
|
||
```bash
|
||
curl -s "https://www.v2ex.com/api/replies/show.json?topic_id=TOPIC_ID&page=1" -H "User-Agent: agent-reach/1.0"
|
||
```
|
||
|
||
### 用户信息
|
||
|
||
```bash
|
||
curl -s "https://www.v2ex.com/api/members/show.json?username=USERNAME" -H "User-Agent: agent-reach/1.0"
|
||
```
|
||
|
||
### Python 调用示例
|
||
|
||
```python
|
||
from agent_reach.channels.v2ex import V2EXChannel
|
||
|
||
ch = V2EXChannel()
|
||
|
||
# 获取热门帖子
|
||
topics = ch.get_hot_topics(limit=10)
|
||
for t in topics:
|
||
print(f"[{t['node_title']}] {t['title']} ({t['replies']} 回复)")
|
||
|
||
# 获取节点帖子
|
||
node_topics = ch.get_node_topics("python", limit=5)
|
||
|
||
# 获取帖子详情 + 回复
|
||
topic = ch.get_topic(1234567)
|
||
print(topic["title"], "—", topic["author"])
|
||
|
||
# 获取用户信息
|
||
user = ch.get_user("Livid")
|
||
```
|
||
|
||
> **节点列表**: https://www.v2ex.com/planes
|
||
|
||
## Reddit (通过 Exa)
|
||
|
||
Reddit 封锁了几乎所有非浏览器访问（包括代理 IP）。搜索和阅读全部通过 Exa 完成，免费且无需代理。
|
||
|
||
### 搜索 Reddit 内容
|
||
|
||
```bash
|
||
mcporter call 'exa.web_search_exa(query: "your search query", numResults: 5, includeDomains: ["reddit.com"])'
|
||
```
|
||
|
||
### 阅读完整帖子和评论
|
||
|
||
```bash
|
||
mcporter call 'exa.crawling_exa(urls: ["https://www.reddit.com/r/SUBREDDIT/comments/POST_ID/TITLE/"], maxCharacters: 10000)'
|
||
```
|
||
|
||
> **零配置**: 只需安装 Exa MCP（`agent-reach install --env=auto` 自动完成）。无需代理，无需 API Key。
|