MCP server DataSocial
Commit 23 de out. de 2026Consulte um enorme data warehouse do TikTok contendo bilhões de criadores, vídeos e sons usando SQL de apenas leitura através de um assistente de IA.
Também conhecido como hashfunction-dev/datasocial-mcp, datasocial-mcp
- Stars
- 0
- Ferramentas
- 4
- Downloads, 30 dias
- —
- Versão mais recente
- 1.0.0
- Último commit
- 23 de out. de 2026
- Licença
- —
O que é o MCP DataSocial?
DataSocial é um MCP server. Consulte um enorme data warehouse do TikTok contendo bilhões de criadores, vídeos e sons usando SQL de apenas leitura através de um assistente de IA. Ele expõe 4 ferramentas, como list_tables, describe_table, examples.
Resumo gerado a partir do README do projeto
Sobre o MCP server de DataSocial
O DataSocial oferece acesso a um enorme warehouse ClickHouse contendo dados do TikTok, incluindo 4,1 bilhões de criadores, 5,5 bilhões de vídeos e 604 milhões de sons. Desenvolvedores podem conectar este MCP server hospedado a clientes como Claude Code, Cursor ou Claude Desktop usando um endpoint de streamable HTTP. Após configurar uma chave de autorização do site do DataSocial, um assistente de IA pode traduzir perguntas em linguagem natural para consultas SQL de apenas leitura para explorar o conjunto de dados.
O servidor inclui ferramentas específicas como list_tables para visualizar contagens de linhas, describe_table para inspecionar tipos de colunas e examples para ver exemplos de perguntas SQL resolvidas. Os usuários podem executar consultas através da ferramenta run_sql, que está sujeita a um limite de 100 linhas e um timeout de execução de 10 segundos por consulta. Essa configuração permite uma análise rápida do crescimento de criadores, tendências de áudio e relações de seguidores sem a necessidade de escrever SQL manualmente.
O que você pode fazer com ele
- 1Analisar tendências de crescimento de criadoresPeça ao assistente para identificar criadores baseados nos EUA com mais de um milhão de seguidores que tiveram o crescimento mais rápido esta semana.
- 2Acompanhar o uso de áudios em altaDetermine quais sons específicos estão aparecendo no maior número de novos vídeos hoje.
- 3Calcular métricas de engajamento por regiãoEncontre a média de visualizações de vídeos produzidos por criadores no Brasil dentro de uma faixa específica de seguidores.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP DataSocial
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP DataSocial no Claude Code
$ claude mcp add --transport http datasocial-mcp https://api.datasocial.ai/mcpInstalar o MCP DataSocial no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"datasocial-mcp": {
"url": "https://api.datasocial.ai/mcp"
}
}
}Instalar o MCP DataSocial no VS Code
.vscode/mcp.json
{
"servers": {
"datasocial-mcp": {
"type": "http",
"url": "https://api.datasocial.ai/mcp"
}
}
}Instalar o MCP DataSocial no VS Code CLI
$ code --add-mcp '{"name":"datasocial-mcp","type":"http","url":"https://api.datasocial.ai/mcp"}'Instalar o MCP DataSocial no Codex
$ codex mcp add datasocial-mcp --url https://api.datasocial.ai/mcpInstalar o MCP DataSocial no Codex config.toml
~/.codex/config.toml
[mcp_servers.datasocial-mcp] url = "https://api.datasocial.ai/mcp"
Instalar o MCP DataSocial no Gemini CLI
$ gemini mcp add -s user --transport http datasocial-mcp https://api.datasocial.ai/mcpInstalar o MCP DataSocial no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"datasocial-mcp": {
"url": "https://api.datasocial.ai/mcp",
"type": "http"
}
}
}Ferramentas do MCP DataSocial 4
Detectadas a partir do READMElist_tablesdescribe_tableexamplesrun_sql
| list_tables | — | |
| describe_table | — | |
| examples | — | |
| run_sql | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelhashfunction-dev/datasocial-mcp is public and reachablegithub.com/hashfunction-dev/datasocial-mcp ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)No licenseProblema encontrado
- Commit ou release no último anoLast commit or release 2026-10-23github.com/hashfunction-dev/datasocial-mcp ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNo tool named like delete, drop or execPassou
- O endpoint remoto responde ao handshake do MCPinitialize answered with protocol 2025-06-18 in 244 msPassou
README
Ver no GitHubDataSocial 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.
Perguntas sobre o MCP DataSocial
Como adiciono o MCP DataSocial ao Claude Code?
Execute claude mcp add --transport http datasocial-mcp https://api.datasocial.ai/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP DataSocial ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais ferramentas o MCP DataSocial oferece?
Ele expõe 4 ferramentas, incluindo list_tables, describe_table, examples, run_sql.
Quais são os limites de consulta do DataSocial?
As consultas são limitadas a 100 linhas e um tempo máximo de execução de 10 segundos.
Que tipo de dados estão disponíveis no warehouse?
O warehouse contém dados de 4,1B de criadores, 5,5B de vídeos, 604M de sons e 113,7B de conexões de seguidores.