Business & Creator Intelligence — MCP

Find companies. Discover creators. Score opportunities. All in one run.

This Actor is a full business and creator intelligence pipeline for AI agents, marketing teams, and growth researchers. It finds real companies via Google Maps, discovers Instagram and TikTok creators by niche and location, scores them by audience fit and engagement, and ranks the best brand-creator opportunities — returning clean, structured JSON with no hallucinated data.

MCP-compatible: works directly with Claude, Cursor, and any MCP-enabled AI agent via the Apify MCP proxy.

---

What it does

Step	What happens
1. Company search	Finds real companies via Google Maps by query and location
2. Website enrichment	Extracts emails, phone numbers, and descriptions from company websites (optional)
3. Creator discovery	Searches Instagram and TikTok for creators matching a niche and country
4. Follower enrichment	Fetches real follower counts for Instagram creators via API
5. Scoring	Scores each creator 0–100 across niche fit, engagement, audience fit, and brand suitability
6. Matching	Matches creators to companies based on industry alignment
7. Ranking	Returns ranked opportunity list: best company + best creator combinations first

---

Tools

Tool	Use case
research_business	Full pipeline — companies → creators → matching → ranked opportunities
search_creators	Find creators by niche, location, and follower range
find_business_creators	Find creators for a specific company
search_companies	Find companies by query + location via Google Maps
analyze_website	Extract contacts, emails, and social links from any website URL
get_company_details	Deep company profile with optional website enrichment
analyze_creator	Profile analysis for a specific creator username
find_contacts	Find contact data for a company domain

---

Active platforms

Platform	Creator discovery	Follower data
Instagram	✅	✅ Real (via API)
TikTok	✅	—

Note: Other platforms (YouTube, LinkedIn, Facebook, X, Reddit, Pinterest, Twitch) are not active in the current version. Follower data for TikTok is not available — TikTok creators are discovered but returned without follower counts.

---

Example: Full pipeline — gaming companies + creators in Germany

{
  "tool": "research_business",
  "query": "gaming companies",
  "location": "Germany",
  "niche": "gaming",
  "platforms": ["instagram", "tiktok"],
  "max_companies": 5,
  "max_creators": 10,
  "direction": "business_to_creator"
}

Output (one item per company):

{
  "rank": 1,
  "company": {
    "name": "Klang Games",
    "industry": "Video Games",
    "address": "Berlin, Germany",
    "website": "https://klang.com",
    "rating": 4.6,
    "reviews_count": 23,
    "confidence": 0.85,
    "source": "google_maps"
  },
  "opportunity_score": 74,
  "top_creators": [
    {
      "platform": "instagram",
      "username": "xperion_germany",
      "profile_url": "https://www.instagram.com/xperion_germany",
      "followers": 50367,
      "followers_source": "instagram_profile_scraper",
      "followers_confidence": "high",
      "engagement_estimate": 3.78,
      "niche": "gaming",
      "country": "Germany",
      "score": {
        "overall": 78,
        "niche_fit": 90,
        "engagement": 65,
        "audience_fit": 90,
        "brand_suitability": 75,
        "explanation": "Overall 78/100 — Strong gaming alignment, 50K followers, verified German audience."
      },
      "confidence": 0.85,
      "match_score": 82
    }
  ],
  "tool": "research_business",
  "direction": "business_to_creator"
}

---

Example: Creator search only

{
  "tool": "search_creators",
  "niche": "fitness",
  "country": "United Kingdom",
  "platforms": ["instagram", "tiktok"],
  "limit": 20,
  "sort_by": "score"
}

Output (one item per creator):

{
  "platform": "instagram",
  "username": "fitnesswithsarah_uk",
  "profile_url": "https://www.instagram.com/fitnesswithsarah_uk",
  "followers": 38500,
  "followers_source": "instagram_profile_scraper",
  "followers_confidence": "high",
  "engagement_estimate": 4.1,
  "niche": "fitness",
  "country": "United Kingdom",
  "score": {
    "overall": 76,
    "niche_fit": 95,
    "engagement": 70,
    "audience_fit": 85,
    "brand_suitability": 72,
    "explanation": "Overall 76/100 — Excellent fitness niche alignment, strong engagement for audience size."
  },
  "confidence": 0.8,
  "tool": "search_creators"
}

---

Example: Match creators to a specific company

{
  "tool": "find_business_creators",
  "company": "Adidas",
  "industry": "sports",
  "country": "Germany",
  "platforms": ["instagram", "tiktok"]
}

---

Example: Website contact extraction

{
  "tool": "analyze_website",
  "website": "https://example-brand.com"
}

---

Scoring explained

Every creator receives a composite score (0–100):

Dimension	What it measures
niche_fit	How well the creator's content matches the target niche
engagement	Estimated engagement rate relative to account size and platform benchmarks
audience_fit	Geographic and demographic alignment with the target country
brand_suitability	Content style and brand safety indicators
overall	Weighted composite of all dimensions

Micro-influencers (10K–100K followers) typically score higher on engagement than mega-influencers — this is by design.

---

Input parameters

Parameter	Type	Required	Description
tool	string	yes	Tool to run (see Tools table above)
query	string	for research_business, search_companies	Search query
niche	string	for creator tools	Content niche: gaming, beauty, fitness, tech…
location	string	for research_business	Country or region: Germany, Europe, US
country	string	for creator tools	Country filter
platforms	array	optional	["instagram","tiktok"] — default: both
max_companies	integer	optional	Max companies (default 10, max 50)
max_creators	integer	optional	Max creators (default 10, max 50)
limit	integer	optional	Max results for search tools (default 10, max 100)
direction	string	optional	business_to_creator or creator_to_business
company	string	for find_business_creators	Company name
username	string	for analyze_creator	Creator username
platform	string	for analyze_creator	instagram or tiktok
website	string	for analyze_website	URL to analyze
min_followers	integer	optional	Minimum follower filter
max_followers	integer	optional	Maximum follower filter (micro-influencer targeting)
language	string	optional	Language filter: German, English…
sort_by	string	optional	score, followers, engagement, confidence
enrich_websites	boolean	optional	Fetch company websites (slower, costs more)
keywords	string	optional	Extra keywords for creator search

---

Pricing (Pay Per Event)

You only pay for actual results — not for failed searches or empty outputs.

Event	Price	When charged
creator_result	$0.02	Per creator returned by search_creators
company_result	$0.02	Per company returned by search_companies / get_company_details
website_enrichment	$0.03	Per website analyzed (analyze_website, enrich_websites=true)
contact_lookup	$0.02	Per find_contacts run
creator_analysis	$0.05	Per analyze_creator run
business_creator_match	$0.10	Per find_business_creators run
combined_research	$0.20	Per company ranked in research_business pipeline

Typical cost examples:

• Search 10 creators → ~$0.20
• Full pipeline, 5 companies → ~$1.00
• Find contacts for 1 company → $0.02

---

MCP usage

Connect any MCP-compatible AI agent (Claude Desktop, Cursor, etc.) to:

https://mcp.apify.com

Then call this Actor as a tool from your agent's system prompt or instructions.

---

Data quality guarantees

• No hallucinations: every result has a source_url and confidence score
• null when not found: phones, emails, followers return null — never placeholder text
• followers_confidence field tells you how reliable the follower data is: high (API-verified), medium (parsed from page), none (not available)
• Cross-platform deduplication: same creator appearing on multiple platforms is merged into one result
• Region expansion: passing "Europe" automatically searches across top European countries

---

Current limitations

• Instagram follower data: real counts via Apify API — accurate and up to date
• TikTok follower data: not available in this version — creators are discovered but returned without follower counts
• Geographic coverage: best results for US, UK, Germany, France, Netherlands, and other major markets
• Creator discovery depth: results depend on public discoverability — private or very small accounts may not appear

---

Example workflows

1. Brand partnership research Run research_business with your industry and target country → get a ranked list of companies and the best matching creators for each.

2. Influencer database building Run search_creators with a niche and multiple countries → collect and score a pool of relevant creators at scale.

3. Competitor analysis Run get_company_details + analyze_website on competitor URLs → extract contacts, social presence, and company info.

4. Creator-first approach Run research_business with direction: creator_to_business → discover creators first, then find the best companies for each.

---

Local development

git clone <repo>
pip install -r requirements.txt
pytest tests/ -v

# Test locally
apify run --input='{"tool":"search_creators","niche":"gaming","country":"Germany","limit":5}'

# Deploy
apify push