tokdata

tokdata

tokdata は、ホストされた HasData TikTok MCP サーバーへの小規模なローカルブリッジです。このサーバーは公開 TikTok データを JSON として返します。ハンドルから公開プロフィールを検索し、公開アカウントが投稿した動画を ページごとにたどり、公開動画のコメント（または1件のコメントへの返信）を読み取り、キーワードで TikTok の動画またはユーザーを検索できます。

このブリッジは TikTok データを一切保持しません。ライブエンドポイントから取得したとおりに、ツール一覧をローカルで返し、各ツール呼び出しを上流に転送して、返された内容を変更せずに返します。取得専用の読み取り専用機能は、公開コンテンツに対する4つの操作です。どのツールも投稿、送信、保存は行わず、機能の中に個人の連絡先情報を含むツールはありません。

ツール

• hasdata_tiktok_profile_getTikTokProfile — 公開プロフィールを取得します。必須：handle（ユーザー名。@ の有無は問いません）。ニックネーム、自己紹介、自己紹介のリンク、アバター URL、認証済みフラグと非公開フラグ、アカウント作成日時、フォロワー数、フォロー数、いいね数、動画数、友達数を返します。
• hasdata_tiktok_posts_getTikTokPosts — アカウントの動画を1ページ分取得します。必須：handle。任意：アカウントの過去の投稿をさらにたどるための nextPageToken。各動画について、説明、ハッシュタグ、メンション、いいね数、コメント数、シェア数、再生数、コレクション数、カバー画像と再生可能な URL、音楽、再生時間、タイムスタンプが返されます。
• hasdata_tiktok_comments_getTikTokComments — 公開動画のコメントを取得します。必須：videoId（動画の URL に含まれる数値 ID）。任意：commentId（トップレベルのコメントの代わりに、そのコメントへの返信を返します）と、ページ送り用の nextPageToken。トップレベルコメントの最初のページには、動画自体の情報も含まれます。
• hasdata_tiktok_search_getTikTokSearch — キーワードで検索します。必須：keyword。任意：type（video または user。デフォルトは動画）と、ページ送り用の nextPageToken。動画の検索結果には通常の各種カウント、URL、音楽、投稿者が含まれます。ユーザーの検索結果にはニックネーム、自己紹介、アバター、認証済みフラグ、フォロワー数が含まれます。

設定

• HASDATA_TIKTOK_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://mcp.hasdata.com/api/mcp?apis=tiktok です。固定 URL の一部である /api/ の セグメントにご注意ください。（上書き用フックは、この再構築版独自のラベル付き再現です。）
• HASDATA_API_KEY（任意）— 設定すると、上流へのすべてのリクエストに、呼び出し元自身の HasData API キーを示す x-api-key: <key> ヘッダーが含まれます。設定されていない場合、キーのヘッダーは送信されません。（ヘッダー名と環境変数名は元のレジストリ記録で固定されています。この環境変数からキーを転送する動作はラベル付き再現であり、元の機能はキーなしで記録されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開きます。JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo name tokdata）を送り、続いて notifications/initialized 通知を送り、その後、呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流が initialize への応答で Mcp-Session-Id ヘッダーを返した場合、その値はセッションの後続のすべてのリクエストに付加され、プロセスの存続中はセッションが再利用されます。応答は通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取ります。

上流からの成功結果は、上流が設定した isError フラグも含め、そのまま返されます。失敗（JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、または完了できないリクエスト）は、テキストが tokdata error: で始まる isError 結果として返されます（このエラー表示は、この再構築版独自のラベル付き再現です）。

CLI

各ツールは、1つの JSON 引数文字列を受け取るサブコマンドとしても実行できます。

npx @reneturcios/tokdata hasdata_tiktok_profile_getTikTokProfile '{"handle":"tiktok"}'
npx @reneturcios/tokdata hasdata_tiktok_posts_getTikTokPosts '{"handle":"tiktok"}'
npx @reneturcios/tokdata hasdata_tiktok_comments_getTikTokComments '{"videoId":"0000000000000000000"}'
npx @reneturcios/tokdata hasdata_tiktok_search_getTikTokSearch '{"keyword":"dance","type":"video"}'
npx @reneturcios/tokdata --version

終了コード：成功時は 0、isError 結果の場合は 1、使用方法のエラーの場合は 2 です。

MCP サーバー

npx -y @reneturcios/tokdata mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "tokdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tokdata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/tokdata
docker run --rm ghcr.io/cloudcorprecords/tokdata --version

コンテナのデフォルトコマンドは mcp なので、最初の形式は stdio MCP サーバーです。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC アップストリームに対して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。