TikTok, LinkedIn ve YouTube dahil olmak üzere 22 sosyal medya platformundan canlı ve halka açık verileri birleşik bir şema üzerinden çekin.
Ayrıca bilinen adı insightsocial/cli, cli
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- 873
- En son sürüm
- 0.3.9
- Son commit
- 6 Kas 2026
- Lisans
- MIT
InsightSocial MCP nedir?
TikTok, LinkedIn ve YouTube dahil olmak üzere 22 sosyal medya platformundan canlı ve halka açık verileri birleşik bir şema üzerinden çekin.
Özet, projenin README dosyasından oluşturuldu
InsightSocial MCP sunucusu hakkında
InsightSocial; TikTok, LinkedIn, YouTube, X ve Reddit dahil olmak üzere 22 farklı sosyal medya platformundan canlı ve halka açık verilere erişmek için birleşik bir yöntem sunar. Video etkileşimi veya gönderi URL'leri gibi verilerin kaynak platformdan bağımsız olarak tutarlı kalması için tek bir şema kullanır. Bu durum, her bir servis için özel scraper yazmak zorunda kalmadan sosyal trendleri, profilleri veya yorumları izlemesi gereken AI agent geliştiren yazılımcılar için ideal bir araç sağlar.
MCP server, npx aracılığıyla yerel olarak çalıştırılabilir veya Claude ve ChatGPT gibi istemcilere bağlanabilir. Kullanıcılar, tarayıcı tabanlı giriş yaparak veya ortam değişkenleri (environment variables) üzerinden bir API key sağlayarak kimlik doğrulaması yapabilirler. Sistem, tam yanıtları yerel olarak kaydederek ve kullanıcılara jq veya belirli alan filtrelerini kullanarak veriyi yeniden dilimleme imkanı tanıyarak LLM context window'ları için verimli olacak şekilde tasarlanmıştır. Bu sayede, büyük veri paketlerinin agent'ı yorması engellenirken, tüm bilgilerin yerel işleme için hazır tutulması sağlanır.
Neler yapabilirsiniz
- 1Platformlar arası veri çekmeBir AI agent, aynı veri yapısını kullanarak hem TikTok hem de YouTube üzerinden video etkileşim metriklerini çekebilir.
- 2Sosyal medya araştırmasıBir geliştirici, çeşitli ağlar genelinde takipçileri veya profilleri aramak için belirli endpoint'leri bulması konusunda bir agent'a talimat verebilir.
- 3Verimli context yönetimiKullanıcılar, AI context limitlerinin aşılmasını önlemek için büyük bir sosyal medya yanıtından yalnızca belirli alanları ayıklayabilirler.
- 4Endpoint keşfiBir geliştirici, hangi bilgilere erişilebileceğini görmek için anahtar kelimelerle mevcut veri noktalarını arayabilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
InsightSocial MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleInsightSocial MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'INSIGHTSOCIAL_API_KEY=<YOUR_INSIGHTSOCIAL_API_KEY>' cli -- npx -y insightsocialInsightSocial MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"insightsocial"
],
"env": {
"INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
}
}
}
}InsightSocial MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"insightsocial"
],
"env": {
"INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
}
}
}
}InsightSocial MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"cli","type":"stdio","command":"npx","args":["-y","insightsocial"],"env":{"INSIGHTSOCIAL_API_KEY":"<YOUR_INSIGHTSOCIAL_API_KEY>"}}'InsightSocial MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"insightsocial"
],
"env": {
"INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
}
}
}
}InsightSocial MCP'yi Codex içine yükleyin
$ codex mcp add cli --env 'INSIGHTSOCIAL_API_KEY=<YOUR_INSIGHTSOCIAL_API_KEY>' -- npx -y insightsocialInsightSocial MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.cli] command = "npx" args = ["-y", "insightsocial"] [mcp_servers.cli.env] INSIGHTSOCIAL_API_KEY = "<YOUR_INSIGHTSOCIAL_API_KEY>"
InsightSocial MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'INSIGHTSOCIAL_API_KEY=<YOUR_INSIGHTSOCIAL_API_KEY>' cli npx -- -y insightsocialInsightSocial MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"insightsocial"
],
"env": {
"INSIGHTSOCIAL_API_KEY": "<YOUR_INSIGHTSOCIAL_API_KEY>"
}
}
}
}Yapılandırma
INSIGHTSOCIAL_API_KEYGizliInsightSocial API key (isk_live_...). Create one at https://www.insightsocial.app/portal/api/keys?utm_source=mcp-registry. Searching and describing endpoints work without it; calling one needs it.
| Ad | Açıklama | Sunucu |
|---|---|---|
| INSIGHTSOCIAL_API_KEY | InsightSocial API key (isk_live_...). Create one at https://www.insightsocial.app/portal/api/keys?utm_source=mcp-registry. Searching and describing endpoints work without it; calling one needs it. | Gizli |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
insightsocial
The official CLI and MCP server for the InsightSocial API: live public data from 22 platforms through one key: TikTok, LinkedIn, YouTube, X, Reddit, Pinterest, Bluesky, Truth Social, Snapchat, Telegram, Twitch, Kick, Rumble, Kwai, Douyin, Xiaohongshu (RedNote), Quora, TikTok Shop, Weibo, Zhihu, Substack and Nextdoor.
- 230+ endpoints: profiles, public emails, posts, videos, comments, followers, likers, hashtags, search, company pages, jobs, ads, transcripts, shop products and local business listings.
- One schema across platforms: a TikTok video and a YouTube video come back with the same fields
(
post.url,post.kind,post.engagement.likes,post.language), andunavailablelists any field a response could not fill. The CLI and MCP server ask for schema 2 on every call. - Priced per endpoint, charged per call. Empty results, failed calls and idempotent replays are free.
- Built for agents. Every result is saved in full, and you re-slice it locally with jq for free, so a 50 KB page never ends up in your context.
Quick start
npx -y insightsocial init # sign in through your browser, install the agent skill, show MCP setup
npx -y insightsocial search tiktok followers
npx -y insightsocial run /v1/tiktok/profile -p handle=natgeo
npx -y insightsocial view --last --jq '.data.author | {username, followers}'
init and login sign you in through your browser: they open the sign-in page and print a short
code, you type the code there and click Allow, and a key named after this machine is saved. The CLI
then prints which account it signed into. To use a key you already have, pass --api-key. New
accounts include free calls.
Use it from an AI agent
Claude Code plugin
/plugin marketplace add insightsocial/skills
/plugin install insightsocial@insightsocial
This installs the skill and the MCP server together, from
insightsocial/skills. Run npx -y insightsocial login once so
the server can find your key.
MCP server (any client)
claude mcp add insightsocial --scope user -- npx -y insightsocial mcp
{
"mcpServers": {
"insightsocial": { "command": "npx", "args": ["-y", "insightsocial", "mcp"] }
}
}
The server reads the key saved by insightsocial login, so the config holds no secret. You can
also pass INSIGHTSOCIAL_API_KEY in its env. Without a key, search and describe still work.
Nothing to install: the same tools are hosted at https://api.insightsocial.app/mcp. Claude,
ChatGPT and other clients that support it sign in with OAuth; others send the key as
Authorization: Bearer. See MCP docs.
| Tool | What it does |
|---|---|
search_endpoints |
Find endpoints by keywords and platform. Free. |
describe_endpoint |
Inputs, allowed values, an example and the price for one endpoint. Free. |
call_endpoint |
Fetch data. Saves the full response and returns a result_id with a trimmed view (10 items by default) and a ready next_call for the next page. |
read_result |
Re-slice a saved result with jq, fields, max_items or an outline with sizes. Free. |
get_credits |
Balance, plan and usage. Free. |
insightsocial init --yes writes the MCP entry into Claude Code, Codex and Cursor for you.
Commands
| Command | |
|---|---|
init [--yes] [--no-skills] |
Save a key, install the skill for detected agents, print or write the MCP config. |
login [--api-key k] [--no-browser] / logout |
Sign in through your browser (or save a key you pass) / remove the key. |
search <words> [--platform p] |
Find endpoints. Free. |
list [--platform p] |
Every endpoint with its price. Free. |
describe <path> |
Inputs, example and price. Free. |
run <path> -p name=value … |
Call an endpoint. Saves to ./.insightsocial/. Options: --input <json>, -i file, --idempotency-key, --fresh, --max-credits N, -o file, --json, and the shaping flags below. |
view [file] [--last [endpoint]] |
Re-shape a saved result. No network, no charge. |
credits |
Balance and usage. Free. |
mcp |
Start the MCP server over stdio. |
Shaping flags (run and view) trim only what is printed; the saved file is always complete:
--jq <expr>: real jq (bundled, nothing to install) over the saved response. Paths start at.data.--fields a,b.c: keep these keys on each item. Dotted paths descend.--max-items N: show at most N items.--summary: the structure with byte sizes, so you can see what is large before pulling it.
Paging: when there is another page, run prints the exact next command. Each page is a
separate charged call.
Pricing a call first: -p dry_run=1 (or true) on any endpoint returns the quote and charges
nothing. When a response could not fill a field the platform normally has, run prints it under
missing; that null means unknown, not zero.
Configuration
| Key | --api-key, then INSIGHTSOCIAL_API_KEY, then ~/.insightsocial/config.json (mode 600) |
INSIGHTSOCIAL_BASE_URL |
Defaults to https://api.insightsocial.app |
INSIGHTSOCIAL_HOME |
Defaults to ~/.insightsocial (config, catalogue cache, MCP results) |
Develop
npm install
npm run check # build + unit tests, no network and no key needed
License
MIT
InsightSocial MCP soruları
InsightSocial MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'INSIGHTSOCIAL_API_KEY=<YOUR_INSIGHTSOCIAL_API_KEY>' cli -- npx -y insightsocial komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
InsightSocial MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Hangi sosyal medya platformları destekleniyor?
TikTok, LinkedIn, YouTube, X, Reddit, Pinterest, Bluesky ve daha pek çok platform dahil olmak üzere 22 platformu destekler.
Servis ücretlendirmesi nasıl yapılıyor?
Fiyatlandırma, kullanılan spesifik endpoint baz alınarak çağrı başına yapılır; ancak boş sonuçlar ve başarısız çağrılar ücretsizdir.