📦

Social Post Extractor MCP

MCP server for extracting scripts and metadata from Douyin and Xiaohongshu links with Bailian ASR, OCR, and script.md/info.json outputs

0 installs

Trust: 34 — Low

Commerce

Ask AI about Social Post Extractor MCP

I know everything about Social Post Extractor MCP. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

Social Post Extractor MCP

统一提取抖音、小红书、Bilibili 内容的 MCP Server。它可以解析作者信息、作品信息、公开视频指标、字幕/转写稿、小红书图文图片内容，并在需要时通过浏览器登录态拉取自己账号的复盘数据。

默认产物：

script.md：给人和 AI 继续阅读、整理、入库的内容稿
info.json：给程序和 AI 使用的结构化数据，包括作者、指标、媒体、transcript、图片分析、模型信息和状态

怎么安装

把这个 GitHub 链接发给你的 AI Agent：

https://github.com/JNHFlow21/social-post-extractor-mcp

然后对它说：

请打开这个仓库，先读 README.md 和 AGENTS.md，然后帮我安装并配置这个 MCP。不要让我复制长提示词，请一步一步带我完成 API Key、MCP 客户端和 smoke test。

安装 agent 应该优先执行 AGENTS.md 里的流程。

能做什么

抖音：公开视频信息、作者信息、指标、视频 transcript
小红书：视频笔记 transcript、图文笔记正文和图片视觉分析
Bilibili：公开视频信息、作者信息、指标、视频 transcript
自己账号复盘：通过本机浏览器登录态拉取作品列表、账号概览、作品详情等数据

设计原则：

外部视频优先使用平台字幕；没有字幕时才走云端 ASR。
小红书图文笔记走云端视觉模型分析图片。
自己账号复盘默认只抓数据，不做 ASR。
不把视频作为长期文件下载到本地。
API Key 默认放在 MCP 仓库内的本机配置文件，不写进 Git。

前置条件

git
Python 3.10+
uv
一个支持 stdio MCP 的客户端，例如 mcporter、Claude Desktop、Claude Code、Codex 或 OpenClaw
阿里云百炼 / DashScope API Key，用于 ASR、视觉模型和清理模型

获取 API Key：

API Key 页面直达：https://bailian.console.aliyun.com/cn-beijing?tab=model#/api-key
官方教程：https://help.aliyun.com/zh/model-studio/get-api-key
Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
ASR URL：https://dashscope.aliyuncs.com/api/v1/services/audio/asr/transcription

找 API Key 的路径：

打开 API Key 页面直达链接。
登录阿里云账号。
如果没有自动进入北京地域，页面右上角选择 华北2（北京）。
归属业务空间选择 默认业务空间。
点击 创建 API Key。
权限选择 全部。
点击 确定。
创建后复制 sk-... 开头的 API Key，发给正在帮你安装的 AI Agent，让它自动填入 config/social-post-extractor.env。

如果要做“自己账号复盘”，还需要：

本机浏览器已经登录对应平台的创作者后台
可用的 browser-backed CLI 环境，例如 opencli / bb-browser

快速安装

git clone https://github.com/JNHFlow21/social-post-extractor-mcp.git
cd social-post-extractor-mcp
uv sync

如果已经克隆过：

cd social-post-extractor-mcp
git pull
uv sync

配置 API Key

不要配置系统环境变量。推荐把明文 key 放在 MCP 仓库里的本机配置文件：

mkdir -p config
cp .env.example config/social-post-extractor.env
chmod 600 config/social-post-extractor.env

Windows PowerShell：

New-Item -ItemType Directory -Force config
Copy-Item .env.example config/social-post-extractor.env

然后把 config/social-post-extractor.env 里的占位值改成真实值：

export ASR_PROVIDER=bailian
export ASR_MODEL=paraformer-v2
export VISION_PROVIDER=bailian
export VISION_MODEL=qwen3-vl-flash
export CLEAN_PROVIDER=bailian
export CLEAN_MODEL=qwen-flash
export BAILIAN_API_KEY=sk-your-real-api-key
export BAILIAN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
export DASHSCOPE_ASR_URL=https://dashscope.aliyuncs.com/api/v1/services/audio/asr/transcription

这个文件在 .gitignore 里，不会被提交。也兼容不带 export 的 KEY=value 写法。

服务会按顺序读取：

config/social-post-extractor.env
.env
~/.mcporter/secrets/social-post-extractor.env
Windows %APPDATA%\social-post-extractor-mcp\config.env

MCP 客户端配置

server 名可以继续叫 douyin，这是为了兼容旧调用；它实际支持抖音、小红书和 Bilibili。

macOS / Linux stdio 配置示例，注意把路径替换成你本机真实路径：

{
  "mcpServers": {
    "douyin": {
      "command": "/bin/zsh",
      "args": [
        "-lc",
        "cd '/ABSOLUTE/PATH/social-post-extractor-mcp' && exec '.venv/bin/python' -m social_post_extractor_mcp"
      ]
    }
  }
}

Windows PowerShell stdio 配置示例：

{
  "mcpServers": {
    "douyin": {
      "command": "powershell",
      "args": [
        "-NoProfile",
        "-ExecutionPolicy",
        "Bypass",
        "-Command",
        "Set-Location 'C:\\ABSOLUTE\\PATH\\social-post-extractor-mcp'; & '.\\.venv\\Scripts\\python.exe' -m social_post_extractor_mcp"
      ]
    }
  }
}

不要把真实 API Key 直接写进 MCP JSON；本服务会自动读取 config/social-post-extractor.env。

验证

在仓库目录执行：

uv run python -m unittest discover -s tests
uv run python -m compileall social_post_extractor_mcp

如果使用 mcporter：

mcporter config list
mcporter call 'douyin.parse_social_post_info(share_link: "https://www.bilibili.com/video/BV19nwvzkEz3/?share_source=copy_web&vd_source=3e5fb861a7d0d1af1134f023ac01f842")'

默认测试链接：

抖音视频：
https://v.douyin.com/72RGMuz7Xpo/

小红书视频：
https://www.xiaohongshu.com/discovery/item/69ee20ef000000003700f942?source=webshare&xhsshare=pc_web&xsec_token=ABSu4AV7InNpMmutizzqOXvEbSYOl4SuMzfQx6rnUVq8Y=&xsec_source=pc_share

小红书图文：
https://www.xiaohongshu.com/discovery/item/69ec4330000000001a02de7d?source=webshare&xhsshare=pc_web&xsec_token=ABIXZbvap57FaFYWymY6oBwwRkz1Chn1orsWGhjJntXYY=&xsec_source=pc_share

Bilibili 视频：
https://www.bilibili.com/video/BV19nwvzkEz3/?share_source=copy_web&vd_source=3e5fb861a7d0d1af1134f023ac01f842

安装 agent 配置完成后，必须自动测试三个平台：

mcporter call 'douyin.parse_social_post_info(share_link: "https://v.douyin.com/72RGMuz7Xpo/")'
mcporter call 'douyin.parse_social_post_info(share_link: "https://www.xiaohongshu.com/discovery/item/69ee20ef000000003700f942?source=webshare&xhsshare=pc_web&xsec_token=ABSu4AV7InNpMmutizzqOXvEbSYOl4SuMzfQx6rnUVq8Y=&xsec_source=pc_share")'
mcporter call 'douyin.parse_social_post_info(share_link: "https://www.xiaohongshu.com/discovery/item/69ec4330000000001a02de7d?source=webshare&xhsshare=pc_web&xsec_token=ABIXZbvap57FaFYWymY6oBwwRkz1Chn1orsWGhjJntXYY=&xsec_source=pc_share")'
mcporter call 'douyin.parse_social_post_info(share_link: "https://www.bilibili.com/video/BV19nwvzkEz3/?share_source=copy_web&vd_source=3e5fb861a7d0d1af1134f023ac01f842")'

三平台 metadata 测试都通过后，再测试至少一次 transcript 或完整采集。推荐优先测试小红书视频，因为它同时验证小红书解析和视频转写链路：

mcporter call --timeout 86400000 'douyin.social_extract_transcript(share_link: "https://www.xiaohongshu.com/discovery/item/69ee20ef000000003700f942?source=webshare&xhsshare=pc_web&xsec_token=ABSu4AV7InNpMmutizzqOXvEbSYOl4SuMzfQx6rnUVq8Y=&xsec_source=pc_share", output_dir: "/tmp/social-post-extract")'
mcporter call --timeout 86400000 'douyin.social_extract_transcript(share_link: "抖音视频链接", output_dir: "/tmp/social-post-extract")'

如果默认小红书链接失效，再让用户提供一个新的小红书链接；没有真实可用的小红书链接时，只能说“部分验证通过”，不能说“三平台全部通过”。

真实提取 transcript 时建议给 output_dir：

mcporter call --timeout 86400000 'douyin.social_extract_transcript(share_link: "你的抖音/小红书/Bilibili链接", output_dir: "/tmp/social-post-extract")'

安装完成后，AI Agent 应该先给出类似这样的回执：

OK，MCP 已安装并通过测试。

测试结果：
- 抖音 metadata：通过
- 小红书 metadata：通过
- Bilibili metadata：通过
- 转写/完整采集：通过

输出文件：
- script.md：实际路径
- info.json：实际路径

以后你可以直接说：
- 帮我转写这个抖音视频：链接
- 帮我转写这个小红书视频笔记：链接
- 帮我提取这个小红书图文笔记的正文、图片内容和数据：链接
- 帮我转写这个 B 站视频：链接
- 帮我看一下这个链接的作者、标题和数据，不用转写：链接

使用教程

配置完成后，学员不用记 MCP 工具名，直接把链接发给 AI Agent 即可。

转写抖音视频

直接说：

帮我转写这个抖音视频，并保存成 script.md 和 info.json：
https://v.douyin.com/xxxx/

Agent 应该调用：

mcporter call --timeout 86400000 'douyin.social_capture_url(share_link: "抖音链接", output_dir: "/tmp/social-post-extract")'

如果只要文字稿，不需要完整信息：

帮我只提取这个抖音视频的转写稿：
https://v.douyin.com/xxxx/

Agent 应该调用：

mcporter call --timeout 86400000 'douyin.social_extract_transcript(share_link: "抖音链接", output_dir: "/tmp/social-post-extract")'

转写小红书视频

直接说：

帮我转写这个小红书视频笔记：
小红书分享链接

Agent 应该调用：

mcporter call --timeout 86400000 'douyin.social_capture_url(share_link: "小红书链接", output_dir: "/tmp/social-post-extract")'

提取小红书图文笔记

直接说：

帮我提取这个小红书图文笔记的正文、图片内容和数据：
小红书分享链接

Agent 应该调用：

mcporter call --timeout 86400000 'douyin.social_capture_url(share_link: "小红书链接", output_dir: "/tmp/social-post-extract")'

图文笔记会保存正文、图片 URL，并用视觉模型分析图片内容。

转写 Bilibili 视频

直接说：

帮我转写这个 B 站视频，并保存结构化信息：
https://www.bilibili.com/video/BVxxxx/

Agent 应该调用：

mcporter call --timeout 86400000 'douyin.social_capture_url(share_link: "B站链接", output_dir: "/tmp/social-post-extract")'

只看作者和数据

如果只想看标题、作者、点赞、评论、收藏等信息，不想跑转写：

帮我看一下这个链接的作者、标题和数据，不用转写：
平台链接

Agent 应该调用：

mcporter call 'douyin.parse_social_post_info(share_link: "平台链接")'

输出在哪里

默认建议输出到：

/tmp/social-post-extract

每次成功提取后，结果里会返回实际路径：

script_path：整理后的 Markdown 文稿
info_path：结构化 JSON 数据

工具列表

parse_social_post_info：只解析作者、作品、指标和媒体信息，不做 ASR
social_extract_transcript：提取视频 transcript，优先平台字幕，没有字幕时走云端 ASR
social_capture_url：统一采集链接，输出 script.md 和 info.json
extract_social_post_script：兼容旧入口，功能接近 social_capture_url
social_analyze_owner_posts：拉取自己账号复盘数据，需要浏览器登录态
parse_douyin_video_info、get_douyin_download_link、extract_douyin_text：旧版兼容工具

常见问题

如果提示 API Key 不存在：

检查 config/social-post-extractor.env 是否存在
检查 BAILIAN_API_KEY 或 DASHSCOPE_API_KEY 是否填了真实值
重启 MCP 客户端

如果 transcript 失败：

先用 parse_social_post_info 确认链接能解析
确认视频 URL 可访问
确认百炼 / DashScope 服务已开通并有额度
把完整错误信息发给安装 agent 排查

如果自己账号复盘失败：

先确认浏览器已经登录对应创作者后台
确认 browser-backed CLI 环境可用
重新运行 social_analyze_owner_posts

安全规则

不要提交真实 API Key。
不要把真实 API Key 贴到公开聊天或 issue。
不要长期保存别人的视频文件。
处理别人的公开视频时可以走云端 ASR；处理自己账号复盘时默认只抓数据。
结果尽量保留结构化字段，不要只保留自然语言摘要。

License

Apache-2.0

Social Post Extractor MCP

Reviews

Documentation

Social Post Extractor MCP

怎么安装

能做什么

前置条件

快速安装

配置 API Key

MCP 客户端配置

验证

使用教程

转写抖音视频

转写小红书视频

提取小红书图文笔记

转写 Bilibili 视频

只看作者和数据

输出在哪里

工具列表

常见问题

安全规则

License

Security Checklist