DataSocial
Query a TikTok data warehouse (creators, videos, sounds, daily history) with read-only SQL.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http datasocial 'https://api.datasocial.ai/mcp' --header 'Authorization: <Bearer <your key>; free key at datasocial.ai/keys (sign in)>'
{
"mcpServers": {
"datasocial": {
"type": "http",
"url": "https://api.datasocial.ai/mcp",
"headers": {
"Authorization": "<Bearer <your key>; free key at datasocial.ai/keys (sign in)>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
DataSocial MCP: query TikTok data from Claude, Cursor or any MCP client
A hosted MCP server over a ClickHouse warehouse of TikTok data: 4.1B creators, 5.5B videos, 604M sounds and 113.7B follow edges (124.6B rows). Ask your AI assistant a question; it writes the SQL and runs it. Free.
- Endpoint:
https://api.datasocial.ai/mcp(Streamable HTTP, stateless) - Key: free. Sign in at datasocial.ai, open the MCP tab, and copy the command with your key already in it.
- Limits: 100 rows per query, 10 s per query, read-only.
Connect
Claude Code
claude mcp add --transport http datasocial https://api.datasocial.ai/mcp \
--header "Authorization: Bearer $DATASOCIAL_KEY"
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"datasocial": {
"url": "https://api.datasocial.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
Claude Desktop (claude_desktop_config.json, via mcp-remote)
{
"mcpServers": {
"datasocial": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.datasocial.ai/mcp", "--header", "Authorization:${AUTH}"],
"env": { "AUTH": "Bearer YOUR_KEY" }
}
}
}
Tools
| Tool | What it does |
|---|---|
list_tables | The tables, their row counts and what one row is |
describe_table | One table's columns, types and sort key |
examples | Worked questions with SQL that runs, plus SQL tips |
run_sql | Runs one read-only SELECT (up to 100 rows) |
Things to ask
- "Which US creators with over 1M followers grew fastest this week?"
- "Which sounds are being used in the most new videos today?"
- "Who does @<username> follow?"
- "What's the average view count of videos by creators in Brazil with 100K–500K followers?"
Daily creator and video history started on 2026-09-26; sound history has 106 days since January 2026.
Also
- Plain SQL or plain-English search in the browser, no account: datasocial.ai
- How the data is collected: Scraping TikTok's mobile API at billions of records a day
- The full database without the 100-row limit, or the scraper code: datasocial.ai/buy
This repo holds documentation only; the server is hosted.
الأسئلة الشائعة
ما هو DataSocial؟
Query a TikTok data warehouse (creators, videos, sounds, daily history) with read-only SQL.
كيف أثبّت DataSocial؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http datasocial 'https://api.datasocial.ai/mcp' --header 'Authorization: <Bearer <your key>; free key at datasocial.ai/keys (sign in)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج DataSocial إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل DataSocial مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون DataSocial؟
ينشره hashfunction-dev. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.