下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/user_59fc9940--agent-social-reader.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_59fc9940/agent-social-reader。让你的AI Agent能够阅读小红书、B站、抖音、微博、公众号、Tiktok、Instagram、X/Twitter、Facebook等20+平台的内容:把社交媒体链接发给你的Agent,自动读取正文并总结要点。无需登录账号、无需Cookie,支持让你的适合快速浏览、竞品研究、信息收集。还能一键将原文、图片、视频和总结存入Notion、Obsidian或ima个人知识库。
阅读全文 (展开查看完整说明)
概述
Agent-Social-Reader — 技能使用指南
🎯 快速理解
作为知识工作者/产品经理/重度 AI Agent 使用者,我们每天丢给 AI 各种 X (Twitter)、Reddit、微信公众号或小红书链接时,最常遇到的就是 AI 访问不了这些社交媒体平台。即使用了各种硬核开源工具,也会遇到各种平台限制和数据格式碎片化问题,导致 AI 吐回来一堆报错和 HTML 乱码。
这个 Skill 解决的问题:
❌ 之前:
你:丢给 Agent 一个 Twitter/Reddit/小红书链接
Agent:"我访问不了" / 返回乱码
你:只能手动复制粘贴,或者截图上传,或者放弃✅ 现在:
你:丢给 Agent 任何社交媒体链接
Agent:自动读取 → 自动总结
你:把它存到 Notion / Obsidian / ima
→ 内容整整齐齐存进知识库(Notion/Obsidian 本地,或 ima )核心价值:
- ✅ 完整闭环:阅读 → 总结 → 存档,一条龙搞定
- ✅ 广泛覆盖:20+ 全球社交平台(TikTok、Instagram、X、YouTube、Reddit、抖音、小红书、B站等)
- ✅ 更低风险:不需要登录个人社交账号,不需要 Cookie,降低因 Cookie 导致的封号风险
- ✅ 灵活成本:免费工具优先,可选付费增强(最低 $2.90/月)
💡 设计理念:能免费的绝不花钱,免费搞不定的再用性价比最高的付费方案。用户自己决定用哪个。
❤️ 特别致谢:Agent-Reach by @Panniantong。Agent-Reach 证明了让 Agent 读取网络内容这件事是可以做到的 – 本项目是同一思路的个人迭代,更聚焦社交内容读取与知识库归档的完整闭环。
✨ 功能列表
安装这个 Skill 之后,你的 Agent 会获得以下能力(无需你写任何代码,告诉 Agent,Agent 自动执行):
| 内容来源 | 使用工具 | 成本说明 |
|---|---|---|
| 普通网页 | Jina Reader (r.jina.ai) | ✅ 免费,无需 Key |
| X/Twitter 公开推文 | FxTwitter API | ✅ 免费,无需 Key 或 cookie |
| YouTube(有字幕) | youtube-transcript-api | ✅ 免费,无需 Key |
| 微博 | Jina Reader (r.jina.ai) | ✅ 免费,绕过登录墙 |
| 微信公众号 | Camoufox | ✅ 免费,无头浏览器处理 JS 渲染 |
| 20+ 全球社交平台 | AgentLens API | 🎁 每月20 次免费使用额度<br>💵 之后 $2.90/月(200 次) |
| 视频总结(TikTok、YouTube 等无字幕) | Whisper 转录 + LLM | ✅ 本地免费(需安装)<br>💵 OpenAI API $0.006/分钟 |
| RSS 订阅 | Python feedparser | ✅ 免费 |
| 全网语义搜索 | Agent runtime 内置搜索 | ✅ 免费(前提是当前运行时支持) |
| 一句话存 Notion | Agent 确认后写入 | ✅ 免费(你的 Notion Token) |
| 一句话存 Obsidian | Agent 确认后写入 | ✅ 免费(本地路径) |
| 一句话存 ima | Agent 确认后写入 | ✅ 免费(ima OpenAPI,微信/飞书/企微均可访问) |
⚠️ 工作区规则
重要:除非用户明确要求在工作区内创建文件,否则不要直接在 Agent 默认工作区内创建或修改文件。
- 所有临时输出和临时缓存统一使用
/tmp/。 - 使用
~/.agent-social-reader/config.json存储长期本地配置。 - 优先使用环境变量存储密钥。切勿打印、日志、摘要化或提交完整 API Key / Token。
- 只有在用户明确要求或确认保存提示后,才能写入 Notion、Obsidian 或 ima。
配置查找顺序
需要凭证或路径时,按以下顺序检查:
- 当前运行时已由用户认证的连接器或 MCP 工具。
- 环境变量:
AGENT_LENS_API_KEY、OPENAI_API_KEY、NOTION_TOKEN、NOTION_DATABASE_ID、OBSIDIAN_VAULT_PATH、IMA_CLIENT_ID、IMA_API_KEY、IMA_KNOWLEDGE_BASE_ID。 - 本地配置文件:
~/.agent-social-reader/config.json。 - 向用户询问缺失的值,说明其用途,并询问是否需要本地保存。
本地配置使用以下 JSON 格式:
{
"agentLensApiKey": "",
"openAiApiKey": "",
"notionToken": "",
"notionDatabaseId": "",
"obsidianVaultPath": "",
"imaClientId": "",
"imaApiKey": "",
"imaKnowledgeBaseId": "",
"defaultArchiveTarget": "",
"imaScenario": ""
}imaScenario 记录当前 ima 写入路径:"ima-native" / "workbuddy" / "external-api"。
🔧 工具路由表
每个平台都有首选(免费)工具和可选备选。首选工具失败时,按顺序尝试下一个选项。只有当免费工具全部耗尽或该平台无法使用免费工具时,才使用 AgentLens。
| # | 平台 | 首选(免费) | 备选 |
|---|---|---|---|
| 1 | 通用网页 | r.jina.ai | 运行时浏览器 / Camoufox |
| 2 | X / Twitter(公开推文) | FxTwitter API | AgentLens API |
| 3 | YouTube(字幕) | youtube-transcript-api | AgentLens API + Whisper |
| 4 | 微信公众号 | Camoufox | AgentLens API |
| 5 | 微博 | r.jina.ai | AgentLens API |
| 6 | 20+ 社交平台 | AgentLens API | — |
| 7 | 视频摘要 | 本地 Whisper | OpenAI Whisper API |
| 8 | RSS 订阅源 | feedparser | — |
| 9 | 网络搜索 | 内置运行时搜索 | — |
| 10 | 保存至 Notion | 原生 API 写入 | — |
| 11 | 保存至 Obsidian | 文件写入(.md) | — |
| 12 | 保存至 ima | 原生 ima 技能(若可用) | ima OpenAPI |
路由原则:优先穷尽免费工具。只有当免费工具失败或该平台无法使用免费工具时,才升级使用 AgentLens。
工具命令和代码详情参见 references/tool-details.md。
⚠️ 读取规则
触发条件:用户要求「读取」或「总结」某个链接 → 且内容以视觉为主(图片或视频承载主要信息,文字为辅助信息:话题标签、配文文字、简短描述)
规则:
- 当工具返回附带文本的媒体文件(图片或视频)时 → 媒体是主要内容
- 图片 → 将 CDN / 媒体 URL 下载为
/tmp/asr_{platform}_{timestamp}.jpg→ 传给 Vision 模型 → 将视觉分析纳入摘要 - 视频 → 按 SOP C(视频摘要)处理
- 当文字是主要内容(文章、帖子、长文本)时 → 从文字提取摘要,无需强制分析媒体 → 只有当用户明确要求分析媒体时才覆盖此规则(例如「分析这些图片/视频」)
- 切勿完全忽略文字——媒体补充文字,文字和媒体共同构成完整信息
注意:不同工具返回媒体格式不同——请检查实际响应结构并相应提取媒体 URL。
🗂️ 临时媒体文件管理
命名规范
本技能创建的所有媒体文件必须使用 asr_ 前缀,以便安全、精准地清理,不会影响其他任务的文件。
| 类型 | 格式 | 示例 |
|---|---|---|
| 视频 | /tmp/asr_ + {platform} + _{timestamp}.mp4 | /tmp/asr_douyin_20260703.mp4 |
| 音频 | /tmp/asr_audio_ + {timestamp}.wav(或 .MP3) | /tmp/asr_audio_20260703.wav |
| 图片 | /tmp/asr_ + {platform} + _{timestamp}.jpg(或 .png、.webp) | /tmp/asr_xhs_20260703.jpg |
时间戳可选,但建议添加以避免命名冲突。
清理触发条件
下载媒体文件的任务完成后,同时满足以下条件时触发清理提示:
- 本次会话中这是第二次或更往后的媒体文件下载,且
/tmp/asr_*文件总大小超过约 1GB
满足任一条件时 → 询问用户:
"临时媒体文件正在积累。可选:(A)立即删除 /(B)每个任务后自动删除 /(C)暂时保留"
- 若用户之前选择了(B)自动删除 → 无需询问直接静默清理
- 清理完成后 → 始终确认删除内容(文件数量 + 释放字节数)
清理规则
重要:
1. 仅删除 /tmp/ 下的文件
2. 仅删除带 `asr_` 前缀的文件——绝不要动没有此前缀的文件
3. 没有 asr_ 前缀的文件可能属于其他任务或进程——不要删除
4. 若无法可靠确认文件是否由本技能创建,则不要删除——改为询问用户清理命令
# 预览——仅在有匹配文件时运行
find /tmp -maxdepth 1 -type f -name 'asr_*' -exec ls -lh {} +
find /tmp -maxdepth 1 -type f -name 'asr_*' -exec du -ch {} +
# 删除——仅在 find 返回非空时运行;防止意外 glob 扩展
find /tmp -maxdepth 1 -type f -name 'asr_*' -delete📋 标准操作流程
SOP A:URL 读取 → 交付
用户分享链接
→ 路由至正确工具(见上方路由表)
→ 读取内容
→ 执行用户意图(摘要 / 分析 / 下载 / 保存 等)
→ 交付结果
→ 若是首次成功执行:
显示记忆持久化提示(见 § 持久化与入门引导)
根据用户响应分支
否则(后续执行):
停止——不再提示 Notion/Obsidian/ima
--- AgentLens API Key 配置(内联,当需要 AgentLens 但找不到 key 时触发)---
→ 若平台需要 AgentLens 且在各查找路径中均未找到 AGENT_LENS_API_KEY:
告知用户:
"该平台需要 AgentLens API Key 才能读取。
它可以解锁 20+ 个主要社交平台。
花10秒钟获取免费 API Key:https://agentlensapi.io/pricing —— 每月免费 20 次请求;付费计划 $2.9/月起(200次),具体见定价页。
你把 API Key 粘贴给我后,我会处理剩余步骤。"
用户粘贴 Key:
→ 仅用于本次请求。
→ 询问:"是否将此 API Key 保存至本地,以便后续使用?"
→ 若用户同意 → 保存至 ~/.agent-social-reader/config.json
→ 若用户不同意 → 不持久化,仅本次使用
→ 检查:本次对话中是否有待处理的 URL?
若有:
→ 执行该 URL 的预期操作
→ 交付结果
→ 触发记忆持久化提示
若无:
→ 停止SOP B:平台不支持 / 自我修复回退
用户分享链接
→ 路由至 AgentLens API
→ API 返回不支持平台的状态码/代码/消息(例如 Status 10032)
→ 不要停止——执行回退:
1. 告知用户:
"该平台目前暂不支持。
我将尝试用通用网页解析器作为回退方案..."
2. 回退 A — Jina Reader:
curl -L -s "https://r.jina.ai/{url}"
若返回有效内容 → 摘要并交付,附注:
"已通过通用网页解析恢复。"
3. 回退 B — 运行时网络搜索(若 Jina 也失败):
使用当前运行时内置的网络/搜索工具(若有)。
若无运行时搜索可用,告知用户搜索功能未配置。
4. 所有路径均失败:
"已尝试所有可用路径,但该链接被反爬机制阻挡。
你可能需要手动打开并向我分享内容。"SOP C:视频摘要
触发条件:用户首次对视频链接的指令包含"摘要"、"这个视频说了什么"或类似意图,且媒体类型为视频。
用户分享带摘要意图的视频 URL
→ 步骤 1:尝试获取字幕
若是 YouTube → 尝试 youtube-transcript-api
若找到字幕 → 摘要 → 完成
若无字幕 → 继续步骤 2
若非 YouTube → 继续步骤 2
→ 步骤 2:在下载前询问用户 Whisper 偏好
告知用户:"该视频没有字幕,因此目前无法摘要语音内容。
如需做到这一点,需要先转写音频。有两个选项:
A) 本地 Whisper(免费)——我会引导你安装 faster-whisper。
你还需要 ffmpeg(已为必需依赖)。
B) OpenAI Whisper API(~$0.006/分钟)——你需要提供 OpenAI API Key。
你选择哪个?"
→ 若用户拒绝 → 仅交付可用元数据/文字;停止
→ 若用户选择 A 或 B → 继续步骤 3
→ 步骤 3:通过 AgentLens API 获取下载 URL
→ 从 downloadUrlList 中提取 sourceUrl(优先选择"video"类型)
→ 若未配置 AgentLens,询问 AGENT_LENS_API_KEY 或尝试字幕/仅搜索回退
→ 步骤 3b:检查是否有直链音频 URL
→ 若 downloadUrlList 包含"audio"类型条目 → 优先使用而非视频
→ 将音频文件直接下载为 `/tmp/asr_audio_{timestamp}.MP3` → 跳过步骤 4 和 5 → 直接进入步骤 6
→ 音频比视频小很多——下载更快,且无需 ffmpeg 提取
→ 步骤 4:下载视频
curl -L --fail --max-time 120 -o /tmp/asr_{platform}_{timestamp}.mp4 "{sourceUrl}"
若 curl 失败 + 是 YouTube → 尝试 yt-dlp
若 curl 失败 + 非 YouTube → 告知用户下载失败
→ 步骤 5:提取音频
(若步骤 3b 已获取音频则跳过此步骤)
ffmpeg -y -i /tmp/asr_{platform}_{timestamp}.mp4 -vn -acodec pcm_s16le -ar 16000 -ac 1 /tmp/asr_audio_{timestamp}.wav
→ 步骤 6:转写
本地 Whisper:faster-whisper(CPU,免费)
API Whisper:OpenAI Whisper API($0.006/分钟)
注:OpenAI Whisper API 有 25MB 文件大小限制。长视频需先拆分为约 5 分钟一段,
然后检查每个片段的文件大小:
任何片段 ≥ 24MB → 重新拆分为 3 分钟或更低码率后再上传。
→ 步骤 7:摘要转写内容 → 交付
→ 任务完成后:见 § 临时媒体文件管理,了解清理触发条件、规则和命令详细下载/转写命令参见 references/tool-details.md §7。
💾 保存至 Notion
触发条件:用户说"保存到 Notion"或在入门引导中确认。
依赖检查优先:先检查是否存在现有的 Notion 工具(notion-cli、mcporter-notion、自定义 Notion 连接器)。若有,则使用该工具而非内置脚本。
内置备选:参见 references/save-scripts.md §Notion。
凭证:若尚未存储,引导用户提供 Notion Integration Token 和数据库 ID 或页面 ID。仅在用户授权后才本地保存。Token 绝不打印或提交。
存档格式(markdown):
# {title}
**Source**: {source_url}
**Platform**: {platform_name}
## Summary
{ai_summary}
## Full Text
{full_text}限制:Notion API 每次请求最多 100 个 children。若内容超过 100 个,询问用户是仅保存摘要还是使用分批 PATCH。切勿静默截断。
成功反馈:
"已成功保存至你的 Notion 阅读列表!以后只需说「保存到 Notion」,我会处理剩余步骤——无需再配置。"
💾 保存至 Obsidian
触发条件:用户说"保存到 Obsidian"或在入门引导中确认。
依赖检查优先:先检查是否存在现有的 Obsidian 集成工具。若有,则使用该工具而非内置脚本。
内置备选:参见 references/save-scripts.md §Obsidian。
凭证:若保险库路径尚未存储,引导用户提供。仅在用户授权后才本地保存。
存档格式(同上 Notion)。
成功反馈:
"已成功保存至你的 Obsidian 仓库!以后只需说「保存到 Obsidian」,我会直接写入 Markdown 文件——无需再配置。"
💾 保存至 ima
触发条件:用户说"保存到 ima"、"存到 ima"、"存到知识库"或在入门引导中确认。
ima 是腾讯的云端知识库产品,通过 OpenAPI(Token + 目标 ID)访问。它可在全渠道使用——在 ima 内、通过飞书、企业微信或任何第三方 Agent。
步骤 1 — 检测运行环境
保存前,先检测当前所处环境:
| 检测信号 | 场景 | 写入路径 |
|---|---|---|
运行时具有 ima-knowledge / ima-note 原生技能 | 场景 1:ima 内 | 直接调用内置 ima 技能 |
| 运行时具有 WorkBuddy 专用工具/连接器 | 场景 2:WorkBuddy | ima OpenAPI |
环境变量 IMA_CLIENT_ID/IMA_API_KEY 存在但无 WorkBuddy 信号,或可执行 shell | 场景 3:其他 Agent | ima OpenAPI + 手动配置 |
若未检测到任何信号 → 询问用户:"你是在哪个平台使用本 skill?(ima / WorkBuddy / 其他 Agent)"
检测到场景后,将 imaScenario 保存至配置,后续运行跳过检测。
场景 1 — 在 ima 内运行
零配置。使用内置 ima 技能:
| 意图 | 动作 |
|---|---|
| 保存至知识库 | 调用 ima-knowledge 技能 → 以 Markdown 格式导入内容 |
| 保存为笔记 | 调用 ima-note 技能 → 创建带标题 + 来源 + 摘要的笔记 |
| 用户需要下载 | file_write + provide_file → 生成下载链接 |
步骤:
- 将解析内容整理为 Markdown(使用下方标准存档格式)
- 调用
ima-knowledge或ima-note传入内容 - 向用户确认成功
⚠️ ima 的
import_urls也可用(ima 爬取并快照 URL),但对于社交链接(TikTok/小红书/X),ima 的爬虫常因反爬机制而失败——导致死链无内容。推荐使用 Markdown 导入,以确保内容持久化。
场景 2 — 在 WorkBuddy 内运行
一次性凭证配置,然后通过 OpenAPI 写入。完整配置说明 → references/tool-details.md §10(WorkBuddy 配置)。
配置完成后,通过 OpenAPI 写入。路径选择:
| 内容类型 | 推荐方式 | 原因 |
|---|---|---|
| 社交链接(TikTok/小红书/X 等) | 方式 B(上传 MD)⭐ | ima 爬虫无法绕过社交平台的反爬墙 |
| 常规网页(博客/新闻) | 方式 A(import_urls) | ima 爬虫可快照公开网页 |
| 用户希望保存 AI 摘要 | 方式 B(上传 MD)⭐ | 即使原始链接失效,内容仍持久保存在 KB 中 |
场景 3 — 在其他 Agent 内运行(OpenClaw/Hermes/Claude Code 等)
一次性凭证配置,然后通过 OpenAPI 写入。完整配置说明 → references/tool-details.md §10(外部 Agent 配置)。
凭证(三个必需):
| 凭证 | 描述 | 获取方式 |
|---|---|---|
IMA_CLIENT_ID | Client ID | ima.qq.com/agent-interface |
IMA_API_KEY | API Key | 同一页面(仅显示一次——立即保存) |
IMA_KNOWLEDGE_BASE_ID | 目标 KB ID | 来自 get_addable_knowledge_base_list API |
环境变量到 HTTP 的映射:
IMA_CLIENT_ID → HTTP 请求头 ima-openapi-clientid
IMA_API_KEY → HTTP 请求头 ima-openapi-apikey
IMA_KNOWLEDGE_BASE_ID → 请求体字段 knowledge_base_id / folder_id凭证存储(环境变量,推荐):
export IMA_CLIENT_ID="your_client_id"
export IMA_API_KEY="your_api_key"或配置文件:~/.config/ima/client_id + ~/.config/ima/api_key。
路径选择:同场景 2。完整 API 详情 → references/tool-details.md §9。
标准存档格式
三个场景使用相同的内容格式:
# {title}
**Source**: {source_url}
**Platform**: {platform_name}
## Summary
{ai_summary}
## Full Text
{full_text}ima API 响应
ima API 响应格式参见 references/tool-details.md §9。
成功反馈:
"已成功保存至你的 ima 知识库!以后只需说「保存到 ima」,我会处理剩余步骤——无需再配置。"
🧠 持久化与入门引导
首次成功读取后(SOP A),显示以下内容:
"内容已获取!为了让以后的使用更方便,你是否希望我将 Agent-Social-Reader 设置为我读取网页和社交媒体内容的默认工具?确认后我会锁定这个偏好。
此外,作为内置能力,我可以在未来自动将读取内容存档至 Notion、Obsidian 或 ima。以后想保存任何内容时,只需说「保存到 Notion」、「保存到 Obsidian」或「保存到 ima」,我会引导你完成一次性配置。"
如果用户同意设为默认工具,仅通过当前运行时的授权记忆机制持久化此偏好。若无已授权的记忆机制,则写入 ~/.agent-social-reader/preferences.json:
{
"useAgentSocialReaderByDefault": true,
"defaultArchiveTarget": "notion"
}defaultArchiveTarget 的有效值:"notion"、"obsidian" 或 "ima"。
重要:切勿将 Markdown 内容写入 JSON 配置文件。
如果用户要求立即保存,立即触发相应的保存工作流。
后续执行:直接返回结果,不再提示存档相关信息,除非用户明确要求。
🩺 诊断表
| 工具 | 症状 | 解决方案 |
|---|---|---|
| r.jina.ai | 返回空内容或遇到登录墙 | 对 JS 渲染页面尝试 Camoufox;对社交内容尝试 AgentLens |
| FxTwitter | NOT_FOUND 或限流 | 回退到 AgentLens API |
| youtube-transcript-api | AttributeError: get_transcript | 使用 YouTubeTranscriptApi().fetch(...) —— 1.x API,非 0.x |
| youtube-transcript-api | 被封锁(403/429)或无字幕 | 回退到 AgentLens + Whisper(SOP C) |
| Camoufox | 导入错误或崩溃 | 运行 pip install camoufox |
| Camoufox | 浏览器启动失败 / 缺少 libgbm | 运行 playwright install-deps |
| Camoufox | Browser.setDefaultViewport 协议错误 | 视为不可用;尝试 Jina Reader、AgentLens,或请用户分享内容 |
| AgentLens | Status 10032 | 触发 SOP B(自我修复回退链) |
| AgentLens | api.agentlensapi.io 上 TLS 失败 | 使用主域名 https://agentlensapi.io/api/v1/fetch |
| AgentLens | AUTH_FAILED 或 HTTP 401 | 请用户提供有效的 AGENT_LENS_API_KEY;不要反复重试 |
| AgentLens | 配额耗尽 | 告知用户;建议升级计划 |
| feedparser | SSL EOF / 网络 TLS 失败 | 重试,先尝试 curl -L |
| Notion 写入 | 403 Forbidden | 验证 Integration Token 对目标数据库有写入权限 |
| Notion 写入 | 属性结构不匹配 | 询问数据库属性名 |
| Obsidian 写入 | 文件未找到 | 确认保险库路径存在且可访问 |
| ffmpeg | "command not found" | 安装:apt install ffmpeg(Linux)、brew install ffmpeg(macOS) |
| Whisper | API 错误或配额耗尽 | 若可用,回退到本地 Whisper |
📦 安装
# 一键安装——粘贴给 AI Agent:
帮我安装 Agent-Social-Reader 技能包:https://github.com/hermiod99-vibe/Agent-Social-Reader