tiktok-organic-mcp

tiktok-organic-mcp

TikTok のオーガニック分析用 MCP サーバーです。TikTok Developer API を通じて、動画のパフォーマンス、エンゲージメント指標、プロフィールの分析情報を取得できます。

Claude Code および MCP 対応のあらゆる AI ツール向けに構築されています。AI アシスタントが、動画、再生数、いいね、コメント、シェア、フォロワー数など、TikTok アカウントのデータに直接アクセスできます。

Rex Jones による The SEO Engine ツールキットの一部です。代理店や企業向けの AI 活用型 SEO・ソーシャルメディアツールです。

このプロジェクトを作った理由

• オープンソースの TikTok オーガニック分析 MCP はありませんでした。 広告用 MCP はありますが、オーガニック分析用のものはありませんでした。
• 有料の代替サービスには費用がかかります。 商用サービスは月額契約が必要です。これは無料のオープンソースです。
• AI が TikTok のデータを確認できるべきです。 「TikTok の動画のパフォーマンスはどうですか？」と尋ねれば、実際のデータに基づいた回答が得られます。

クイックスタート

オプション 1：npx（インストール不要）

単一アカウント：

{
  "mcpServers": {
    "tiktok-organic": {
      "command": "npx",
      "args": ["-y", "tiktok-organic-mcp"],
      "env": {
        "TIKTOK_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

複数アカウント：

{
  "mcpServers": {
    "tiktok-organic": {
      "command": "npx",
      "args": ["-y", "tiktok-organic-mcp"],
      "env": {
        "TIKTOK_ACCOUNTS": "[{\"name\":\"mybrand\",\"access_token\":\"act.xxx\",\"client_key\":\"abc123\",\"refresh_token\":\"rft.xxx\"},{\"name\":\"otherbrand\",\"access_token\":\"act.yyy\",\"client_key\":\"def456\",\"refresh_token\":\"rft.yyy\"}]"
      }
    }
  }
}

オプション 2：クローンしてビルド

git clone https://github.com/lanternrow/tiktok-organic-mcp.git
cd tiktok-organic-mcp
npm install
npm run build

次に、Claude Code の MCP 設定に追加します。

{
  "mcpServers": {
    "tiktok-organic": {
      "command": "node",
      "args": ["/path/to/tiktok-organic-mcp/dist/index.js"],
      "env": {
        "TIKTOK_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

TikTok アクセストークンの取得

ステップ 1：TikTok Developer App を作成する

1. TikTok Developer Portal にアクセスしてログインします
2. Manage apps → Connect an app をクリックします
3. アプリの詳細を入力し、審査に提出します

ステップ 2：Login Kit を追加してスコープをリクエストする

1. アプリのダッシュボードで、Login Kit プロダクトを追加します
2. 次のスコープをリクエストします。
   • user.info.basic — プロフィール名、アバター
   • user.info.profile — 自己紹介、認証状況
   • user.info.stats — フォロワー数・フォロー数、いいねの合計数
   • video.list — 動画一覧と指標へのアクセス

ステップ 3：OAuth フローを完了する

1. ユーザーを TikTok の認証 URL に誘導します。

   https://www.tiktok.com/v2/auth/authorize/
     ?client_key={your_client_key}
     &scope=user.info.basic,user.info.profile,user.info.stats,video.list
     &response_type=code
     &redirect_uri={your_redirect_uri}
   

2. 認証コードをトークンと交換します。

   POST https://open.tiktokapis.com/v2/oauth/token/
   Content-Type: application/x-www-form-urlencoded
   
   client_key={client_key}
   &client_secret={client_secret}
   &code={auth_code}
   &grant_type=authorization_code
   &redirect_uri={redirect_uri}
   

3. レスポンスから access_token と refresh_token を保存します

ヒント： アクセストークンの有効期限は 24 時間です。refresh_token ツールを使用するか、TIKTOK_REFRESH_TOKEN を設定すると、自動更新が有効になります。

複数アカウントのサポート

1 つの MCP サーバーから複数の TikTok アカウントを監視できます。TIKTOK_ACCOUNTS 環境変数に JSON 配列を設定します。

[
  {
    "name": "mybrand",
    "access_token": "act.xxx",
    "client_key": "abc123",
    "refresh_token": "rft.xxx"
  },
  {
    "name": "otherbrand",
    "access_token": "act.yyy",
    "client_key": "def456",
    "refresh_token": "rft.yyy"
  }
]

各アカウントオブジェクトには、次の項目が必要です。

• name — 任意に指定する一意のラベル（ツール呼び出しで使用）
• access_token — OAuth アクセストークン

任意の項目：

• client_key — トークンの更新に必要
• refresh_token — トークンの更新に必要

ツールでのアカウントの使用： すべてのツールで、任意の account パラメーターを指定できます。省略した場合、配列の先頭にあるアカウントがデフォルトで使用されます。

get_user_info(account: "mybrand")
get_videos(account: "otherbrand", max_count: 10)

後方互換性： アカウントが 1 つだけの場合は、従来の単一環境変数形式（TIKTOK_ACCESS_TOKEN）も引き続き使用できます。この形式では、「default」という名前のデフォルトアカウントが作成されます。

ツール

アカウントツール

ツール	説明
list_accounts	設定済みのすべての TikTok アカウントとデフォルトアカウントを一覧表示します

読み取りツール

ツール	説明
get_user_info	プロフィールのメタデータ：ユーザー名、自己紹介、フォロワー数・フォロー数、いいねの合計数、動画数、認証状況
get_videos	エンゲージメント指標（再生数、いいね、コメント、シェア）付きの公開動画一覧をページ分割して取得します
get_video_details	指定した動画 ID の詳細な指標を取得します（一度に最大 20 件）

ユーティリティツール

ツール	説明
refresh_token	リフレッシュトークンを新しいアクセストークンと交換します（アカウント設定に client_key と refresh_token が必要です）

すべての読み取りツールとユーティリティツールでは、対象アカウントを指定するための任意の account パラメーターを使用できます。

アーキテクチャ

src/
  index.ts          # MCP server entry point, tool registration
  accounts.ts       # Multi-account resolution and configuration
  client.ts         # TikTok API HTTP client (native fetch, no dependencies)
  types.ts          # TypeScript interfaces for API responses
  tools/
    user.ts         # get_user_info
    videos.ts       # get_videos, get_video_details
    utils.ts        # refresh_token

• 外部 HTTP 依存なし — Node 18+ のネイティブ fetch を使用します
• マルチアカウント対応 — 1 つのサーバーから複数の TikTok アカウントを監視できます
• 後方互換性 — 単一トークンの環境変数も引き続き使用できます
• カーソルベースのページネーション — 動画の一覧取得はカーソルによるページネーションに対応しています
• Zod による検証 — すべてのツール入力を、わかりやすいエラーメッセージ付きで検証します
• 動画の一括クエリ — 1 回のリクエストで最大 20 件の動画の詳細を取得できます

環境変数

マルチアカウント（推奨）

変数	必須	説明
TIKTOK_ACCOUNTS	はい	アカウントオブジェクトの JSON 配列（「マルチアカウント対応」セクションを参照）

単一アカウント（レガシー）

変数	必須	説明
TIKTOK_ACCESS_TOKEN	はい	Login Kit フローで取得した OAuth アクセストークン
TIKTOK_CLIENT_KEY	更新時	アプリの Client Key（トークンの更新に必要）
TIKTOK_REFRESH_TOKEN	更新時	リフレッシュトークン（トークンの更新に必要）

開発

npm run dev    # Watch mode — recompiles on save
npm run build  # Production build
npm start      # Run the server

コントリビューション

Issue と PR を歓迎します。TikTok が API を変更した場合は、Issue を作成してください。

ライセンス

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

---

Rex Jones による The SEO Engine の一部として開発されました。