tiktok-influencer-finder

name tiktok-influencer-finder description Find TikTok influencers using Apify's Influencer Discovery Agent. Use when the user wants to discover TikTok creators or influencers in any niche. argument-hint ["niche/description"] 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: Niche/Description : What type of influencer? (use $ARGUMENTS if provided, otherwise ask) Minimum follower count : e.g. 5K, 10K, 50K Maximum follower count : e.g. 50K, 100K, 500K Location filter : e.g. US only, US + Canada, any English-speaking country 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 Flag Default Description --description required Describe the type of influencer to find --keywords 5 Number of search keywords to generate (max 5) --profiles-per-keyword 10 Profiles per keyword (max 10) --min-followers none Minimum follower count filter --max-followers none Maximum follower count filter --min-fit 0.0 Minimum fit score (0.0-1.0) --output json Output format: json , csv , summary --token env var Apify token (overrides env vars) --timeout 300 Max 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.