socialscrape

socialscrape-mcp

SocialScrape MCP サーバー：Claude、ChatGPT、Cursor、その他あらゆる MCP クライアント向けのソーシャルメディアデータ（プロフィール、投稿、コメント、検索、広告、文字起こし）を提供します。SocialScrape はこのサーバーを https://api.socialscrape.dev/mcp でホストしています。このパッケージを使えば、同じサーバーをお使いのマシン上で実行できます。

このサーバーはSocialScrape のエンドポイントレジストリから生成されており、エージェントがエンドポイントごとに 1 つではなく、使いやすい数のツールを利用できるようにグループ化されています。

ツール	内容
get_transcript、search、get_profile、get_post、get_comments	複数のプラットフォームでエージェントが最もよく行う作業です。プラットフォームは引数で指定します。
プラットフォームごとに 1 つ（github、facebook、twitter、...）	resource でデータ（user、profile.posts、...）を選び、パラメーターを指定します。
describe	正確なパラメーター、使用可能な値、料金、引数の例を確認できます。無料で、API 呼び出しは発生しません。
call_endpoint、batch、get_job、monitors、get_credits	ID による任意のエンドポイント呼び出し、1 回の呼び出しで最大 100 件のリクエスト、非同期ジョブ、Webhook、残高の確認ができます。

ツールとして表示されるのは、ビルド済みのエンドポイントのみです。プラットフォームは、そのエンドポイントがビルドされた次のリリースで表示されます。

すべての結果は ok | credits charged: 1 | credits remaining: 4999 で始まります（構造化コピーにも各数値がフィールドとして含まれます）。失敗は無料で、API のエラーコード、retryable フラグ、次の対処方法を含む isError として返されます。

利用方法

ホスト版（基本の方法）。 SocialScrape はこのサーバーを https://api.socialscrape.dev/mcp（ストリーミング可能な HTTP）で実行しています。サインイン方法は 2 つあります。

1. キーをコピーせずにサインインします。URL をコネクターとして追加し、SocialScrape アカウントでサインインして接続を承認します。
   • Claude：Settings、Connectors、Add custom connector の順に選択し、URL を貼り付けます。
   • ChatGPT：URL を使ってコネクターを追加し、OAuth を選択します。
   • Cursor：URL を使ってサーバーを追加し、求められたらサインインします。
   • Claude Code：claude mcp add --transport http socialscrape https://api.socialscrape.dev/mcp を実行し、続けて /mcp でサインインします。
2. ヘッダーに API キーを指定します：x-api-key: ss_live_...。
   • Claude Code：claude mcp add --transport http socialscrape https://api.socialscrape.dev/mcp --header "x-api-key: ss_live_..."
   • Cursor の場合、~/.cursor/mcp.json に次のように記述します。

{ "mcpServers": { "socialscrape": {
    "url": "https://api.socialscrape.dev/mcp",
    "headers": { "x-api-key": "ss_live_..." } } } }

サインイン済みの接続はそれぞれ、ダッシュボードに「MCP connector」という名前のキーとして表示されます。呼び出しは他のキーと同様にチームに課金され、そのキーを取り消すと該当するコネクターの接続が解除されます。利用できるツールはこのパッケージのものと同じです。ツールの一覧を絞り込むには、URL に ?platforms=github,threads または ?toolsets=core を追加します。

ローカル（このパッケージ）。 オフラインのクライアントで使う場合や、ご自身のマシン上でサーバーを実行する場合は、MCP クライアントが stdio 経由でサブプロセスとして起動します。

{ "mcpServers": { "socialscrape": {
    "command": "uvx", "args": ["socialscrape-mcp"],
    "env": { "SOCIALSCRAPE_API_KEY": "ss_live_..." } } } }

キーは https://socialscrape.dev/sign-up?utm_source=github&utm_medium=repo&utm_campaign=socialscrape-mcp で取得できます。キーがなくてもツールの検出はできます。キーを指定せずにツールを呼び出すと、追加方法が表示されます。

ツール数を減らす。 クライアントによってはツール数に上限があります（Cursor は 40 個を超えると警告します）。env ブロックで一覧を絞り込みます。

	設定
一部のプラットフォームのみ	SOCIALSCRAPE_PLATFORMS=github,threads
クロスプラットフォームツールとアカウントツールのみ	SOCIALSCRAPE_TOOLSETS=core
プラットフォームツールのみ	SOCIALSCRAPE_TOOLSETS=platforms

core のみを指定した場合でも、エージェントは describe と call_endpoint を通じてすべてのエンドポイントを利用できます。

ご自身で HTTP 経由で提供する。 ご自身が管理するホストでホスト版サーバーのコピーを実行するには、追加パッケージをインストールします：pip install 'socialscrape-mcp[http]'。続けて socialscrape-mcp http --host 127.0.0.1 --port 8080 を実行します。各リクエストには、専用のキーを x-api-key ヘッダー（または Authorization: Bearer ...）で指定します。また、?platforms= と ?toolsets= でツールを絞り込めます。このコピーはご自身で実行し、セキュリティを確保してください。

設定（環境変数）

変数	デフォルト
SOCIALSCRAPE_API_KEY	なし	stdio のみ。HTTP モードでは各リクエストのキーを読み取ります
SOCIALSCRAPE_API_URL	https://api.socialscrape.dev
SOCIALSCRAPE_MCP_TRIM	1	特に指定がない限り、trim=true を指定します（null フィールドと extra を含めません）。コンテキストを節約できます
SOCIALSCRAPE_MCP_MAX_CHARS	100000	回答の最大文字数です。これを超えるリストは項目単位で切り詰められ、トランスクリプトはウィンドウ（offset）単位で返されます
SOCIALSCRAPE_MCP_TIMEOUT	70	API の応答を待つ秒数です
SOCIALSCRAPE_MCP_ALLOWED_ORIGINS	任意	HTTP モードのみ。カンマ区切りのリストです。ほかのオリジンからのブラウザー呼び出しを拒否する場合に設定します
SOCIALSCRAPE_PLATFORMS、SOCIALSCRAPE_TOOLSETS	すべて	上記を参照してください