mcpField
T
tiktok-influencer-finder

tiktok-influencer-finder

github.com/gooseworks-aiマーケティング・グロース1.3k42 回インストール3 日前に更新
リポジトリ

tiktok-influencer-finder について

ApifyのInfluencer Discovery Agentを使い、分野に合うTikTokクリエイターを探すコマンドラインスキルです。フォロワー数、地域、関連度で候補を絞り込みたいマーケター向けです。

主な機能

  1. 01説明文からTikTokクリエイターを検索
  2. 02フォロワー数と適合度で絞り込み
  3. 03キーワード数と検索プロフィール数を設定
  4. 04条件に合うプロフィールを並べて提示

活用シーン

  1. 01ニッチなキャンペーン向けのクリエイター探し
  2. 02AI・テクノロジー分野のレビュー投稿者探し
  3. 03フォロワー規模でインフルエンサーを選定
  4. 04地域とサブジャンルで候補を絞り込み

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gooseworks-ai/goose-skills --skill tiktok-influencer-finder

インストール後、Claude Code で/tiktok-influencer-finderを入力して読み込まれたか確認します。

同梱ファイルscripts/find_influencers.pyskill.meta.json

詳細

TikTok インフルエンサー検索

Apify の Influencer Discovery Agent を使用して、特定のニッチに合う TikTok インフルエンサーを検索します。

クイックスタート

requests と、GOOSEWORKS_API_KEY または APIFY_API_TOKEN のいずれかの環境変数が必要です。

# Basic search
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "fitness coaches for women over 40"

# With follower filters
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "AI and tech reviewers" \
  --min-followers 10000 --max-followers 500000

# Summary table output
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "vegan cooking creators" --output summary

# CSV export
python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "sustainable fashion" --output csv

ステップ 1：条件を集める

検索を実行する前に、ユーザーに絞り込み条件を尋ねます。以下をすべて確認してください。

  1. ニッチ／説明：どのようなインフルエンサーをお探しですか？（指定があれば $ARGUMENTS を使用し、なければ尋ねます）
  2. 最小フォロワー数：例：5K、10K、50K
  3. 最大フォロワー数：例：50K、100K、500K
  4. 地域の絞り込み：例：米国のみ、米国＋カナダ、英語圏の国ならどこでも
  5. サブニッチの希望：より広いニッチの中で、特定のコンテンツ分野はありますか？

やり取りを最小限にするため、5つの条件をすべて1つの質問で尋ねます。妥当なデフォルトの選択肢を提示しつつ、必ず自由入力も受け付けてください。

ステップ 2：検索を実行する

ユーザーのニッチ、コンテンツスタイルの希望、ターゲットオーディエンスを組み合わせて、詳細な --description を作成します。具体的でわかりやすく記述してください。

python3 skills/tiktok-influencer-finder/scripts/find_influencers.py \
  --description "fitness coaches targeting women over 40, focus on home workouts and healthy aging" \
  --min-followers 5000 --max-followers 500000 \
  --min-fit 0.6 \
  --output json

このスクリプトは apify~influencer-discovery-agent アクターを使用します。GOOSEWORKS_API_KEY が設定されている場合は GooseWorks プロキシ経由で、APIFY_API_TOKEN が設定されている場合は Apify に直接接続します。

ステップ 3：結果を絞り込む

結果を受け取ったら、ユーザーの条件を適用します。

  • 最小フォロワー数を下回るプロフィールを除外します
  • 最大フォロワー数を上回るプロフィールを除外します
  • 指定された地域外のプロフィールを除外します
  • サブニッチに合わないプロフィールを除外します（関連性の判断には fit スコアと fitDescription を使用します。通常、fit が 0.6 未満のものは除外します）
  • 残りの結果を fit スコアの降順、次にフォロワー数の降順で並べ替えます

ステップ 4：結果を提示する

絞り込んだ結果を、見やすい Markdown テーブルで提示します。

| クリエイター | ハンドル | フォロワー数 | エンゲージメント | 地域 | 分野 | 適合スコア |

以下を含めてください。

  • クリックできる TikTok プロフィールへのリンク
  • 読みやすい形式のフォロワー数（例：46.3K）
  • パーセンテージ形式のエンゲージメント率
  • コンテンツの分野に関する簡潔な説明
  • AI が生成した適合スコア

テーブルの後に、以下を含めてください。

  • 分析したプロフィールの総数と条件に一致したプロフィール数
  • 一致した結果が非常に少ない場合は、条件の調整を提案する注記
  • 別のキーワードや調整した条件で検索を再実行する提案

CLI リファレンス

フラグデフォルト説明
--description必須検索するインフルエンサーの種類を説明します
--keywords5生成する検索キーワードの数（最大 5）
--profiles-per-keyword10キーワードごとのプロフィール数（最大 10）
--min-followersなし最小フォロワー数の絞り込み
--max-followersなし最大フォロワー数の絞り込み
--min-fit0.0最小適合スコア（0.0-1.0）
--outputjson出力形式：json、csv、summary
--token環境変数Apify トークン（環境変数より優先）
--timeout300Apify の実行に許可する最大秒数

注意事項

  • このスキルは TikTok のみを検索します。他のプラットフォームを希望する場合は、TikTok 専用であることを伝え、代替案を提案してください。
  • バイラル投稿によって、フォロワー数に対して不釣り合いな反応が発生した場合、エンゲージメント率が 100% を超えることがあります。
  • インフルエンサー検索エージェントの完了には、検索範囲に応じて 1～3 分かかることがあります。

コメント

Markdown 対応