本文へ移動
cccskills
無料GitHub で公開

tiktok-influencer-finder

Find TikTok influencers using Apify's Influencer Discovery Agent. Use when the user wants to discover TikTok creators or influencers in any niche.

インストール方法を見る

含まれるファイル(3)

  • SKILL.md4.3 KB
  • scripts/find_influencers.py8.2 KB
  • skill.meta.json271 B

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

TikTok Influencer Finder

Search for TikTok influencers matching a specific niche using Apify's Influencer Discovery Agent.

Quick Start

Requires requests and either GOOSEWORKS_API_KEY or APIFY_API_TOKEN env var.

# 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

Step 1: Gather Criteria

Before running the search, ask the user for their filtering criteria. Collect ALL of the following:

  1. Niche/Description: What type of influencer? (use $ARGUMENTS if provided, otherwise ask)
  2. Minimum follower count: e.g. 5K, 10K, 50K
  3. Maximum follower count: e.g. 50K, 100K, 500K
  4. Location filter: e.g. US only, US + Canada, any English-speaking country
  5. Sub-niche preferences: Any specific content focus within the broader niche

Ask all 5 criteria in a single question to minimize back-and-forth. Provide sensible default options but always allow custom input.

Step 2: Run the Search

Compose a detailed --description combining the user's niche, content style preferences, and target audience. Be specific and descriptive.

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

The script uses apify~influencer-discovery-agent actor. It routes through the GooseWorks proxy when GOOSEWORKS_API_KEY is set, or directly to Apify when APIFY_API_TOKEN is set.

Step 3: Filter Results

After receiving results, apply the user's criteria:

  • Remove profiles below minimum follower count
  • Remove profiles above maximum follower count
  • Remove profiles outside the specified location(s)
  • Remove profiles that don't match the sub-niche (use the fit score and fitDescription to judge relevance; generally exclude fit < 0.6)
  • Sort remaining results by fit score (descending), then by follower count (descending)

Step 4: Present Results

Present filtered results in a clean markdown table:

| Creator | Handle | Followers | Engagement | Location | Focus | Fit Score |

Include:

  • Clickable TikTok profile links
  • Follower count formatted readably (e.g. 46.3K)
  • Engagement rate as percentage
  • Brief description of their content focus
  • The AI-generated fit score

After the table, include:

  • Total profiles analyzed vs profiles matching criteria
  • A note if very few results matched (suggest adjusting criteria)
  • Offer to run another search with different keywords or adjusted criteria

CLI Reference

FlagDefaultDescription
--descriptionrequiredDescribe the type of influencer to find
--keywords5Number of search keywords to generate (max 5)
--profiles-per-keyword10Profiles per keyword (max 10)
--min-followersnoneMinimum follower count filter
--max-followersnoneMaximum follower count filter
--min-fit0.0Minimum fit score (0.0-1.0)
--outputjsonOutput format: json, csv, summary
--tokenenv varApify token (overrides env vars)
--timeout300Max seconds for Apify run

Notes

  • This skill searches TikTok specifically. If the user wants other platforms, let them know this is TikTok-only and suggest alternatives.
  • Engagement rates above 100% can occur when viral posts drive disproportionate interaction relative to follower count.
  • The influencer discovery agent may take 1-3 minutes to complete depending on search breadth.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Research supported advertising promises from a specific buyer's context, current product facts, customer language and observed ads. Turn them into static, video or copy ideas; match video ideas to actual recipes and save a product-scoped angle bank for write-video-ad-script. Product-led discovery can use verified facts without reviews. Reference persistence and reach are observations, not proof of performance.

日本語の概要は準備中です。原文の説明を表示しています。

gooseworks-ai/goose-skills1,2452026年10月13日 更新

Analyze ad campaign performance data (Google, Meta, LinkedIn) to identify what's working, what's wasting budget, and specific cut/scale/test recommendations. Runs statistical analysis, funnel diagnostics, and multi-channel budget reallocation with specific dollar-amount shift recommendations and scenario modeling.

日本語の概要は準備中です。原文の説明を表示しています。

gooseworks-ai/goose-skills1,2452026年10月13日 更新

For paid lead-gen and participant-recruitment ads, replaces vanity CPA with true CAC per qualified lead by joining ad-platform data with downstream funnel events, surfaces tracking gaps, and classifies every creative into Scale / Keep / Investigate / Cut.

日本語の概要は準備中です。原文の説明を表示しています。

gooseworks-ai/goose-skills1,2452026年10月13日 更新

The intake stage of a Meta ad harness. Researches the brand first, states what it assumes, and asks only what it cannot infer and what would change money, claims or legal exposure if guessed wrong — at most four questions a turn, in plain business language. Writes the brand's stable facts (ads/brand.md), the campaign brief, and a log of what was asked vs assumed. Use it when someone wants to run Meta ads and the brand's ad facts are not yet recorded.

日本語の概要は準備中です。原文の説明を表示しています。

gooseworks-ai/goose-skills1,2452026年10月13日 更新

Analyze the message match between your ads and landing pages. Checks if the promise in the ad copy carries through to the landing page headline, body, and CTA. Flags disconnects that kill conversion rates. Works with Google, Meta, and LinkedIn ads.

日本語の概要は準備中です。原文の説明を表示しています。

gooseworks-ai/goose-skills1,2452026年10月13日 更新

Turn a brand's facts, a campaign brief and the product into a one-minute Meta ad strategy with its reasoning — goal, audience, objective and placements, budget split, how many ads and how different they must be (generate 3x so the user can choose), the test frame, the success metric, and safety rules for the user to accept. Decides what launch-meta-ad-campaign then executes, and re-reads the strategy after a deep check to show which assumption changed. Use it after intake and before any creative is generated or any campaign is built.

日本語の概要は準備中です。原文の説明を表示しています。

gooseworks-ai/goose-skills1,2452026年10月13日 更新

gooseworks-ai のスキルをすべて見る

このスキルの問題を報告する