LamaTok

lamatok-mcp

LamaTok — TikTok データ API 用の MCP サーバーです。npm で利用できます：lamatok-mcp。

起動時に LamaTok の OpenAPI 仕様から MCP ツールを生成します。ツールは REST エンドポイントに 1 対 1 で対応します（GET /v1/user/by/username → get_v1_user_by_username）。デフォルトでは、タスクごとに 1 つ、アシスタントがいつ使うべきかを説明する記述付きのコアツール約 23 個が利用できます。LAMATOK_TOOLS=all に設定すると、非推奨ではないすべてのエンドポイントが公開されます。

API リクエスト 100 件を無料で取得

**こちらのリンクから登録**すると、LamaTok のリクエスト 100 件を無料で取得できます。クレジットカードは不要です。MCP サーバーの接続、Claude／Cursor／Codex でいくつかのプロンプトを試す、導入を決める前にデータ品質を評価する、といった用途に十分な件数です。

こちらから無料リクエスト 100 件を取得

クイックスタート

1. lamatok.com で API キーを取得します。
2. AI アシスタントにサーバーを追加します。
3. アシスタントに次のような質問をします：
   • 「@nasa の TikTok プロフィールを取得して。」
   • 「user_id 6707206320333226502 の直近の動画を 10 件一覧表示して。」
   • 「ハッシュタグ photography の最近の TikTok 動画を探して。」

Claude Code

claude mcp add lamatok -e LAMATOK_KEY=your-api-key -- npx -y lamatok-mcp

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "lamatok": {
      "command": "npx",
      "args": ["-y", "lamatok-mcp"],
      "env": {
        "LAMATOK_KEY": "your-api-key"
      }
    }
  }
}

Cursor / Windsurf

Claude Desktop と同じ形式です。アプリの MCP 設定ファイルで、mcpServers の下にブロックを追加してください。

Zed

~/.config/zed/settings.json に追加します：

{
  "context_servers": {
    "lamatok": {
      "command": "npx",
      "args": ["-y", "lamatok-mcp"],
      "env": {
        "LAMATOK_KEY": "your-api-key"
      }
    }
  }
}

OpenAI Codex

~/.codex/config.toml に追記します：

[mcp_servers.lamatok]
command = "npx"
args = ["-y", "lamatok-mcp"]

[mcp_servers.lamatok.env]
LAMATOK_KEY = "your-api-key"

ツール

ツールは、起動時にライブの LamaTok OpenAPI 仕様から生成されます。デフォルトのコアツールでは、タスクごとに 1 つのエンドポイントを残し、バージョン違いの重複を除外しています：

グループ	ツール数	例
プロフィールとオーディエンス	12	get_v1_user_by_username、get_v2_user_medias_by_secUid、get_v1_user_followers_by_username
動画とコメント	4	get_v1_media_by_url、get_v1_media_by_id、get_v1_media_comments_by_id
ダウンロードリンク	4	get_v1_media_video_download_by_url、get_v1_media_music_download_by_id
ハッシュタグと検索	3	get_v1_hashtag_info、get_v1_hashtag_medias、get_v2_search

コアツールには、手作業で作成した説明（ツールの機能、類似ツールより優先すべき状況、ページネーション、課金に関する情報）が付属し、すべてのツールには読み取り専用の注釈が付いています。リストは src/curated.ts にあります。

LAMATOK_TOOLS=all に設定すると、代わりに非推奨ではないすべてのエンドポイントが公開されます。ツール名は以前と同じなので、既存のプロンプトは引き続き動作します。ツール名はエンドポイントに対応します（GET /v1/user/by/username → get_v1_user_by_username）。現在のリストとパラメータスキーマを確認するには、MCP 経由で tools/list を呼び出してください。どちらのモードでも、/sys、Legacy、System のタググループは除外されます。

設定

変数	説明	必須
LAMATOK_KEY	LamaTok のアクセスキー（x-access-key ヘッダーとして送信）	はい
LAMATOK_URL	ベース URL。デフォルト：https://api.lamatok.com	いいえ
LAMATOK_SPEC_URL	OpenAPI 仕様の URL。デフォルト：${LAMATOK_URL}/openapi.json	いいえ
LAMATOK_TOOLS	core（デフォルト）：厳選されたセットで、タスクごとに 1 つのツール。all：非推奨でないすべてのエンドポイント	いいえ
LAMATOK_TAGS	許可リスト：これらのタグを持つオペレーションのみを含めます（カンマ区切り）	いいえ
LAMATOK_EXCLUDE_TAGS	除外リスト：Legacy、System、/sys に加えて除外するタグ	いいえ
LAMATOK_TIMEOUT_MS	API 呼び出しごとのタイムアウト。デフォルト：30000	いいえ
LAMATOK_SPEC_TIMEOUT_MS	起動時の仕様取得のタイムアウト。デフォルト：60000	いいえ
LAMATOK_SPEC_RETRY_DELAY_MS	起動時の仕様取得を 3 回試行する間の基本待機時間。デフォルト：2000	いいえ
LAMATOK_MAX_RESPONSE_BYTES	各 API レスポンスから読み取る最大バイト数。デフォルト：10485760（10 MB）	いいえ
LAMATOK_MAX_SPEC_BYTES	OpenAPI 仕様から読み取る最大バイト数。デフォルト：8388608（8 MB）	いいえ

Legacy、System、/sys タグはデフォルトで除外されます。非推奨のオペレーションもスキップされます。

LAMATOK_URL が api.lamatok.com 以外のホストを指している場合、サーバーは起動時に警告を出力します。キーはそのホストに送信されるため、セルフホストまたはプロキシ経由の LamaTok にのみ使用してください。

リクエストは User-Agent: lamatok-mcp/<version> を付けて送信されます。

動作の仕組み

AI Assistant ←stdio→ lamatok-mcp ──https──> api.lamatok.com
                          │
                          └─ fetches /openapi.json once on startup,
                             builds one MCP tool per GET endpoint
                             (core set by default)

ツールの引数は、エンドポイントの query パラメーターと path パラメーターに対応付けられます。レスポンス本文はそのまま（JSON テキストとして）返されます。2xx 以外のレスポンスは、HTTP ステータスと本文を含むツールエラーとして通知されます。

開発

git clone https://github.com/subzeroid/lamatok-mcp.git
cd lamatok-mcp
npm install
npm run build
LAMATOK_KEY=your-key node dist/index.js

ウォッチモードで実行します：

LAMATOK_KEY=your-key npm run dev

テストを実行します（ユニットテストと、ローカルモックサーバーに対する stdio スモークテスト。ネットワークや API キーは不要です）：

npm test

ライセンス

MIT