Social Media Toolkit

Усильте агента
Установка от издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
В реестре пока нет пакетного релиза. Следуйте README репозитория.
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
ЗапускОт издателя

Public Python SDK, CLI, and MCP server for extracting metadata, text, timed transcripts, media, and supported comments from Douyin, RedNote, Bilibili, and YouTube.
Maturity: alpha. The normalized
PostBundlecontract is versioned, but public platform pages and endpoints can change without notice.
Social Media Toolkit is an open-source Python SDK, socialkit CLI, and Model Context Protocol (MCP) server for developers and AI agents that need one auditable interface for public social-media extraction. It does not require a browser profile, cookies, a logged-in session, Agent Switch, or the maintainer's machine.
Prerequisite: Node.js 18+ with npm / npx.
npx -y github:risingjerry/social-media-toolkit
socialkit doctor
The installer:
uv when available or downloads it from the official Astral installer;uv tool environment;socialkit and social-media-toolkit-mcp on the user command path;.env file.socialkit doctor returns JSON. A machine with only the free public-reading path configured can report "status": "partial"; use its warnings field to see which optional text or long-recording capabilities are unavailable.
{
"status": "partial",
"supported_platforms": ["douyin", "xiaohongshu", "bilibili", "youtube"],
"local_asr_fallback": false,
"warnings": ["optional capability setup guidance"]
}
Run the same npx command to update. Uninstall with:
uv tool uninstall social-media-toolkit
git clone https://github.com/risingjerry/social-media-toolkit.git
cd social-media-toolkit
uv sync --locked
uv run socialkit doctor
Inspect a public share URL without downloading media or starting GetNote / ASR:
socialkit inspect "SHARE_URL"
The command returns a normalized, provenance-bearing bundle:
{
"schema_version": "1.0",
"source": {"platform": "youtube", "url": "https://example.invalid/public-post"},
"post": {"title": "Example public post"},
"media": {"videos": [], "covers": [], "images": [], "audio": []},
"content": {},
"comments": {},
"provenance": {"routes": ["platform:public"]}
}
The example is synthetic. Real fields depend on what the public source exposes.
If the free Douyin parser fails and TIKHUB_API_KEY is configured, inspect
automatically uses the paid TikHub fallback and records that route plus the
ephemeral-media warning in provenance.
Douyin comment sorting applies only to the public sample returned by the source. It is not a platform-wide ranking, and the toolkit does not paginate or backfill missing items.
The normal readable-text route has one deterministic order:
flowchart LR
U["Public link"] --> G["GetNote original content"]
G -->|"no usable text"| P["Free public platform parser"]
P -->|"Douyin parse failure + key"| H["Optional TikHub media fallback"]
P --> N["Native subtitle or post body"]
H --> N
N -->|"video still has no text"| V["Volcengine cloud ASR"]
V -->|"failure"| E["Explicit error"]
There is no local Whisper fallback, alternate ASR provider, OCR/Vision fallback, LLM rewriting, browser automation, CDP, Playwright, or cookie-backed extraction.
Timed YouTube mode is a separate evidence route because every segment must point back to the source video:
manual subtitle cues → automatic subtitle cues → timed Volcengine ASR
It writes only the requested MD/SRT/JSON artifacts to an explicit output directory. Temporary media is deleted before the call returns. --force-asr --speaker-info can bypass existing captions and request anonymous speaker clusters such as SPEAKER_01; those labels do not identify real people.
The standard route uploads one temporary private TOS object, submits a presigned URL, and deletes the object on success or failure.
Public metadata, public media downloads, supported public comments, and native captions do not require a Volcengine key.
npm install -g @getnote/cli
getnote auth login
GetNote manages its own credentials. Its service may require a paid membership. Calling text, a text-enabled capture, or a full-chain smoke test is the execution signal for the documented route and can save the URL to the user's GetNote account.
Secret name:
TIKHUB_API_KEY
The toolkit always tries the free public Douyin adapter first. Only when that adapter fails and this secret is configured does the single orchestrator call TikHub's Web share-URL endpoint. TikHub supplies normalized public metadata and temporary CDN media URLs; it is not a text or ASR provider. Requests may incur TikHub charges, and returned CDN URLs can expire. The route, cost warning, and ephemeral-URL status are preserved in every result.
Get a key and API documentation from TikHub,
then inject it through the process environment, MCP client, or another secret
manager. Never write it to a project .env file.
Secret names:
VOLCENGINE_ASR_API_KEY
TOS_ACCESS_KEY
TOS_SECRET_KEY
Non-sensitive long-recording settings:
TOS_BUCKET
TOS_REGION
TOS_ENDPOINT
TOS_OBJECT_PREFIX # optional
TOS_PRESIGN_EXPIRES # optional
Inject secrets through the operating system, MCP client, or another secret manager. Do not commit them or write them to a project .env file. Non-sensitive TOS settings may instead live at ~/.config/social-media-toolkit/config.json:
{
"volcengine_tos": {
"bucket": "example-private-bucket",
"region": "example-region",
"endpoint": "https://example-tos-endpoint.invalid",
"object_prefix": "social-media-toolkit/long-asr"
}
}
The repository never stores secret values. Agent Switch is an optional maintainer integration, not a package dependency.
# Metadata only: no persistent write, GetNote, or ASR
socialkit inspect "SHARE_URL"
# Readable canonical text; may use GetNote, paid TikHub media, or paid ASR
socialkit text "SHARE_URL"
# Timed YouTube transcript artifacts
socialkit text "YOUTUBE_URL" \
--timed \
--output "/absolute/path/to/transcripts" \
--outputs md,srt,json
# Force timed ASR with anonymous speaker clusters
socialkit text "YOUTUBE_URL" \
--timed --force-asr --speaker-info \
--asr-context-file "/absolute/path/to/public-context.json" \
--output "/absolute/path/to/transcripts" \
--outputs json,md,srt
# Bounded Douyin public-comment sample
socialkit comments "DOUYIN_URL" --sort likes --limit 20
# Explicit persistent media download
socialkit download "SHARE_URL" \
--include video,cover,images \
--output "/absolute/path/to/output"
--speaker-info and --asr-context-file require --force-asr. Context is a bounded public-metadata vocabulary hint, not identity mapping.
from social_media_toolkit import SocialMediaToolkit
toolkit = SocialMediaToolkit()
bundle = toolkit.inspect("SHARE_URL")
text = toolkit.get_text("SHARE_URL")
timed = toolkit.get_text(
"YOUTUBE_URL",
timed=True,
output_dir="/absolute/path/to/transcripts",
outputs="md,srt,json",
)
comments = toolkit.get_comments("DOUYIN_URL", sort_by="likes", limit=20)
The SDK, CLI, and MCP server use the same SocialMediaToolkit orchestrator and the same versioned result contracts.
Release 0.4.1 intentionally constrains the Python MCP SDK to
mcp>=1.28.1,<2: this transport still uses the v1 FastMCP API. MCP 2.x
renamed and changed that server API, so a future v2 migration will be handled
as a separate compatibility change instead of breaking fresh installs.
Start the stdio server:
social-media-toolkit-mcp
Client configuration:
{
"mcpServers": {
"social-media-toolkit": {
"command": "social-media-toolkit-mcp"
}
}
}
Do not place secrets in this JSON. Use the client's secret store or secure process environment.
Install the bundled skill so your agent knows the commands, JSON output, and safety rules:
npx skills add risingjerry/social-media-toolkit
Manual copy: cp -R skills/social-media-toolkit ~/.claude/skills/ (Claude Code) or ~/.agents/skills/ (Codex and compatible agents). Or register the MCP server (social-media-toolkit-mcp) as shown above. Example prompts:
Working on the repo itself? Agents should read AGENTS.md.
The downloader accepts HTTP(S), rejects local/private literal IPs, bounds download size, sanitizes filenames, and records SHA-256 manifests. See SECURITY.md for private vulnerability reporting.
npx installer and isolated uv tool environment.
uv sync --locked
uv run python -m unittest discover -s tests
uv run python -m compileall social_media_toolkit social_post_extractor_mcp
uv build
npm test
npm pack --dry-run
git diff --check
Tests use synthetic fixtures and must not contain real cookies, tokens, private media, or user content.
Run socialkit text "URL" for plain text, or socialkit text "YOUTUBE_URL" --timed --output ./transcripts for Markdown, SRT, and JSON with source timecodes. It prefers existing subtitles and falls back to Volcengine cloud ASR only when needed.
Use socialkit text "SHARE_URL" for text and socialkit download "SHARE_URL" --output ./downloads for video, cover, and images. Both work from public share links without logging in.
Yes. The CLI and the MCP server read public pages only, so Claude Code, Codex, or any MCP client can call them without a browser profile, cookies, or a logged-in session.
Public metadata, media downloads, and native subtitles are free. Optional routes can cost money: GetNote, the TikHub Douyin fallback, and Volcengine ASR. The result's provenance and warnings say which route ran.
In process environment variables or your MCP client's secret store, never in a project .env file. socialkit doctor lists the secret names it looks for and never prints values.
Douyin, Xiaohongshu, Bilibili, and YouTube public URLs. Private content, account analytics, and publishing are out of scope; you remain responsible for platform terms and copyright.
No. Volcengine cloud ASR is the only ASR provider, by design.
uv tool uninstall social-media-toolkit
rm -rf ~/.claude/skills/social-media-toolkit ~/.agents/skills/social-media-toolkit # if you installed the skill
rm -f ~/.config/social-media-toolkit/config.json # optional config, if you created it
Remove the social-media-toolkit entry from your MCP client config if you added one. Output directories you chose are not touched.
Bug reports and focused feature proposals are welcome through GitHub Issues. Read CONTRIBUTING.md before opening a pull request, and use GitHub's private vulnerability reporting for security issues.
Licensed under the Apache License 2.0.
If this saved you time, a star on GitHub helps others find it.
Public Python SDK, CLI, and MCP server for extracting metadata, text, timed transcripts, media, and supported comments from Douyin, RedNote, Bilibili, and YouTube.
Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
В этой записи не указано обязательных переменных окружения.
Social Media Toolkit работает локально через stdio.
Последняя проверка: 2026-10-27. Public Python SDK, CLI, and MCP server for extracting metadata, text, timed transcripts, media, and supported comments from Douyin, RedNote, Bilibili, and YouTube.