socialdatax_get_points_balanceLABSCO SUMMARY
Two ways into every object, because you rarely have the ID.
Nearly every lookup is paired: one tool takes the identifier, the other takes what a person actually has — a share link, a short link, or the block of text Douyin puts on the clipboard. That is what makes it usable from a conversation, where the input is normally something pasted rather than an aweme_id. The read-only boundary is the other deliberate decision: no login and no account actions at all, so an agent connected to this cannot act in your name. Two mechanics decide whether it behaves — pagination continues only when the returned page_token is passed back, and a transcript is a job you poll on the same job_id rather than a call that returns the text.
What it is
A hosted MCP service for Douyin (抖音) content research at https://mcp.socialdatax.com/douyin/mcp. The surface reads only — hot search, works, creators, comments and video transcripts — with no login, posting, liking or commenting anywhere in it. This repository carries the connection docs and metadata; the implementation is hosted.
What you get
- douyin_get_hot_search_list returns the current main hot search list
- douyin_search_videos searches works by term and douyin_search_users searches creators and accounts, both continuing through pages with page_token
- Work details from either end: douyin_get_video_detail_by_aweme_id when you already have the ID, douyin_get_video_detail_by_url when all you have is a link, a short link or pasted share text
- Comments the same way — douyin_get_video_comments_by_aweme_id and douyin_get_video_comments_by_url — with douyin_get_video_comment_replies_by_comment_id for the replies underneath, which needs both aweme_id and comment_id
- Creator profiles three ways: by sec_user_id, by the public douyin_id, or resolved from a profile link, short link or share text
- Their output too: douyin_get_user_posted_videos_by_sec_user_id or by profile URL for published works, and douyin_get_user_series_by_sec_user_id or by profile URL for short-drama and series lists
- Video transcripts: submit with douyin_submit_video_speech_text_by_video_url or by aweme_id, then poll douyin_get_video_speech_text_job with the job_id it returned — each poll waits up to 240 seconds and this surface returns transcript plus content context rather than a summary
- socialdatax_get_points_balance reports what is left on the key
Requirements
The endpoint is https://mcp.socialdatax.com/douyin/mcp over streamable HTTP with Authorization: Bearer <YOUR_SOCIALDATAX_API_KEY>, and keys come from socialdatax.com. Clients that speak only stdio reach it through mcp-remote carrying the same header. Usage is metered in points. The files in this repository are MIT; that does not extend to the hosted service.
Setup effort
Paste a URL with a key — add the endpoint to your client
USE CASES
01
Seeing what is climbing right now
The current hot search list, then a keyword search over works to see how a topic is actually being made rather than just named.
02
Turning a link someone sent into data
Resolve a share link, short link or pasted share text into the full work record, then read its comments and the replies beneath them.
03
Vetting a creator before working with them
Read the profile from whatever you have — link, douyin_id or sec_user_id — then page through what they have actually published.
04
Finding accounts in a niche
Search creators by term with paging, then open the profiles worth a closer look, including any short-drama series they run.
05
Getting the words out of a video
Submit the transcript job from a link or an aweme_id and poll the same job_id until it reaches a terminal state, checking the points balance as you go.
19 tools
Listed in project docs. Your client may show a different list.
douyin_get_hot_search_listdouyin_search_videosdouyin_search_usersdouyin_get_video_detail_by_aweme_iddouyin_get_video_detail_by_urldouyin_get_video_comments_by_aweme_iddouyin_get_video_comments_by_urldouyin_get_video_comment_replies_by_comment_iddouyin_get_user_info_by_sec_user_iddouyin_get_user_info_by_douyin_iddouyin_get_user_info_by_profile_urldouyin_get_user_posted_videos_by_sec_user_iddouyin_get_user_posted_videos_by_profile_urldouyin_get_user_series_by_sec_user_iddouyin_get_user_series_by_profile_urldouyin_submit_video_speech_text_by_video_urldouyin_submit_video_speech_text_by_aweme_iddouyin_get_video_speech_text_jobBEFORE YOU INSTALL
What to know first
Tools you get
19 tools named in the project's documentation.
Requires
- A client that can reach a remote MCP server over HTTP
- SOCIALDATAX_API_KEY in your environment
Where it runs
All 3 documented clients connect to a hosted endpoint.
INSTALLATION
Connect your client
Add the endpoint to your client.
Server setup
ENDPOINT URL
https://mcp.socialdatax.com/douyin/mcpMCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport http socialdatax-douyin https://mcp.socialdatax.com/douyin/mcp --header 'Authorization: Bearer ${SOCIALDATAX_API_KEY}'Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"socialdatax-douyin": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.socialdatax.com/douyin/mcp",
"--header",
"Authorization: Bearer ${SOCIALDATAX_API_KEY}"
],
"env": {
"SOCIALDATAX_API_KEY": "<YOUR_SOCIALDATAX_API_KEY>"
}
}
}
}Any MCP client — HTTP
ANY MCP CLIENT — HTTP · JSON
{
"mcpServers": {
"socialdatax-douyin": {
"type": "streamable_http",
"url": "https://mcp.socialdatax.com/douyin/mcp",
"headers": {
"Authorization": "Bearer <YOUR_SOCIALDATAX_API_KEY>"
}
}
}
}
