linkfox-kalodata-tiktok-creator

Kalodata - TikTok クリエイター検索と詳細

このスキルは、Kalodata データソースを通じて、次の 2 ステップで TikTok クリエイターを調べるワークフローをサポートします。

1. クリエイターランキングを参照して、実績の高い TikTok Shop クリエイターを見つけます。
2. creatorId を指定して、クリエイターのプロフィールと実績の詳細を取得します。

ランキング、インフルエンサーの発見、クリエイターの比較を求められた場合は、検索エンドポイントを使用します。ユーザーがすでに creatorId を持っている場合、またはランキング結果からクリエイターを 1 人選択している場合は、詳細エンドポイントを使用します。

主な概念

クリエイターランキングエンドポイントは、region、dateRange、language、currency で絞り込める、ページ分割されたランキングを返します。デフォルトのランキング順は、revenue（GMV）の降順です。各クリエイターの行には、識別情報、オーディエンス、コンテンツの視聴数、販売量、動画／ライブ配信の収益、収益成長率が含まれます。

クリエイター詳細エンドポイントは、creatorId でクリエイターを1 人取得します。クリエイターの識別情報、オーディエンス、収益の内訳、動画／ライブ配信の指標、商品／ショップ数、連絡先情報を返します。creatorId は通常、ランキング結果の creator_id フィールドから取得します。

どちらのエンドポイントも、統計データに遅延（T+1）が生じる場合があります。リクエストとレスポンスの詳細については、references/api.md を参照してください。

データフィールド

ランキングの行には、次の項目が含まれます。

Field	Description
creator_nickname	クリエイターの表示名
creator_handle	TikTok のハンドル名
creator_id	クリエイター固有の ID。詳細を取得する際に creatorId として渡します
creator_followers	フォロワー数。文字列として返されます
content_views	コンテンツの合計視聴数。文字列として返されます
sales_volumn	販売量。フィールド名は volumn と綴られています
revenue	指定した通貨での GMV 合計
video_revenue	動画からの収益
live_revenue	ライブ配信からの収益
revenue_growth_rate	収益成長率（%）

詳細の行には、さらに次の項目が含まれます。

Field	Description
creator_region / creator_status / creator_bio	クリエイターのプロフィール情報
new_followers	指定した期間内の新規フォロワー数
unit_price	指定した通貨での平均単価
video_number / video_views / video_gpm	動画数、視聴数、GPM
live_number / live_views / live_gpm	ライブ配信数、視聴数、GPM
product_number / shop_number	関連する商品数とショップ数
creator_contact_*	メールアドレスとソーシャルメディアの連絡先情報。空の場合がよくあります

パラメーターガイド

クリエイターランキング（/kalodata/creator/rank）

Parameter	Type	Required	Description
region	string	No	市場地域コード。例：US
dateRange	string	No	期間。例：last7Day、last30Day
pageNumber	integer	No	ページ番号。1～5
pageSize	integer	No	ページサイズ。5～100
language	string	No	レスポンス言語。例：zh-CN、en-US
currency	string	No	金額指標の通貨。例：USD
category_ids	array	No	カテゴリー ID のリストによるフィルター
shop_id	string	No	ショップ ID によるフィルター
revenue_range	string	No	収益／GMV の範囲によるフィルター
creator_type	string	No	クリエイターの種類によるフィルター
followers_range	string	No	フォロワー数の範囲によるフィルター
engagement_rate	string	No	エンゲージメント率によるフィルター
sortField	object	No	並べ替えの指定。デフォルトの収益ランキングを使う場合は {} を渡します

クリエイター詳細（/kalodata/creator/detail）

Parameter	Type	Required	Description
creatorId	string	Yes	ランキングの creator_id フィールドから取得する、クリエイター固有の ID
shop_id	string	No	ショップ ID によるフィルター
category_ids	array	No	カテゴリー ID のリストによるフィルター
region	string	No	市場地域コード。例：US
dateRange	string	No	期間。例：last7Day、last30Day
language	string	No	レスポンス言語。例：zh-CN、en-US
currency	string	No	金額指標の通貨。例：USD

呼び出し方法

• API エンドポイント：POST /kalodata/creator/rank または POST /kalodata/creator/detail（パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照）
• Python スクリプト：python scripts/kalodata_creator_search.py '<JSON 参数>' [--inline] または python scripts/kalodata_creator_detail.py '<JSON 参数>' [--inline]
• コストの制約：このツールは計算リソースを消費します。同じセッションで同じパラメーターの組み合わせに対する呼び出しは、デフォルトで1回のみです。スクリプトには24時間のローカルキャッシュがあります。失敗や結果が空の場合、キーワードを自動で変更したり、ページをめくったり、郵便番号を変えて連続して試したりしてはいけません。検索を続ける必要がある場合は、追加の消費が発生することを先にユーザーに説明してください。

出力方法（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-kalodata-tiktok-creator-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリで、Claude Code では現在のプロジェクトディレクトリです。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動でまとめられます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
• レスポンス本文が8 KB以下の場合：ファイルに保存した後、完全な JSON を stdout に出力します
• レスポンス本文が8 KBを超える場合：ファイルに保存した後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken など一般的な件数、最大のリストフィールドの長さと先頭3件のサンプル）
• --inline を付けると、stdout にすべてを強制的に出力します（同様にファイルにも保存します）

データの読み取りに関する推奨事項：まず要約を確認して十分か判断してください。具体的なフィールドが必要な場合は、保存された JSON ファイルから jq または ConvertFrom-Json を使って必要な情報だけを抽出し、JSON 全体がコンテキストに入るのを避けてください。

認証と計算リソースの問題の解決

以下の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが401または402
• 計算リソースまたは残高が不足していることを示すレスポンス：メッセージに「計算リソース残高不足／請求額不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれている場合。

使用例

1. 米国の TikTok クリエイター上位を閲覧する

{"region":"US","dateRange":"last7Day","pageSize":10,"pageNumber":1,"currency":"USD"}

2. クリエイター1人の詳細を取得する

{"creatorId":"7153432386608251946","region":"US","dateRange":"last7Day","currency":"USD"}

3. 検索から詳細取得までのワークフロー

Run kalodata_creator_search.py first, choose a row's creator_id, then pass that value as creatorId to kalodata_creator_detail.py.

表示ルール

1. ランキング結果は、ニックネーム、ハンドル、フォロワー数、コンテンツの再生数、販売数、売上高、動画／ライブ配信の売上高、成長率を含む表で表示してください。
2. 詳細結果は、プロフィールを1つのグループにまとめ、基本情報、オーディエンス、売上高、動画、ライブ配信、商品／ショップ、連絡先を表示してください。
3. 指標を表示する際は、必ず dateRange、region、currency を明記してください。
4. creator_followers と content_views は文字列型の件数として扱い、数値を比較する前に解析してください。
5. フィールド名は正確に sales_volumn を使用してください。
6. 連絡先フィールドは値がある場合にのみ表示し、値がない場合は連絡先の提供がないと伝えてください。
7. ユーザーが対応している sortField を明示的に指定しない限り、ランキングの順序を維持してください。

重要な制限事項

• ランキングはキーワード検索ではなく、地域と期間を指定してランキングを閲覧します。
• 詳細の取得には creatorId が必要です。ニックネームまたはハンドルだけではクリエイターを検索できません。
• ランキングのレスポンスには合計件数／ページ数が含まれません。pageSize より少ない件数のページが返されるまでページを取得してください。
• pageNumber は1～5、pageSize は5～100に制限されています。
• 一時的な上流エラーは、Kalodata の HTTP 554 メッセージを伴う errcode 501 として現れる場合があります。同じパラメーターで1～2回再試行してください。パラメーターを自動で変更してはいけません。
• クリエイター以外のエンティティには、対応する Kalodata の商品／動画／ショップ／ライブ配信のスキルを使用してください。

ユーザーの表現とシナリオのクイックリファレンス

該当する -- TikTok クリエイターのランキングまたはプロフィールの検索：

ユーザーの表現	シナリオ
「TikTokクリエイターランキング」、「TikTokインフルエンサーランキング」	クリエイターランキングの検索
「TikTok販売クリエイターランキング」、「top TikTok creators」	地域別クリエイターランキング
「過去7日間のTikTokクリエイターランキング」	期間指定のランキング
「TikTokクリエイターの詳細」、「クリエイターのプロフィールデータ」	クリエイター詳細の検索
「クリエイターの連絡先」、「creator contact」	連絡先
「kalodata creator search/detail」	データソースの直接指定

該当しない -- TikTok クリエイター以外のデータが必要な場合：

• TikTok の商品／動画／ショップ／ライブ配信のランキングまたは詳細
• Amazon／Shopify／1688／その他のプラットフォームのクリエイターまたは商品データ
• TikTok 広告キャンペーンの管理またはコンテンツの作成

計算リソース消費ルール

呼び出しごとに計算リソースを 7.0 消費します。

ユーザーは計算リソースの消費に応じて料金を支払います。十分にご検討ください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが計算リソースの消費量を十分に把握していない場合は、必ずユーザーにお知らせし、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

次のいずれかに該当する場合は、Feedback API を通じてフィードバックを自動検出し、報告してください。

1. このスキルで説明されている機能や目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満や称賛を表明する
4. 改善できると思われる点がある

references/api.md に記載されている方法でフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

---

高品質でプロフェッショナルな越境ECスキルをもっとお探しなら、LinkFox Skills をご覧ください。