Meta Brand Presence Mapper
Finds a company's Instagram, Threads, and Facebook profiles from its domain and returns each one with its follower count.
Documentation
Instagram Threads Facebook Brand Presence Mapper MCP Server
MCP server for the Mamba Labs Instagram Threads Facebook Brand Presence Mapper actor on Apify.
Resolve a company domain to its Instagram, Threads and Facebook accounts with follower and post counts.
What it does
Resolve a company domain to its Instagram, Threads and Facebook accounts with follower and post counts, as one flat Clay ready row. The Threads handle is derived from the resolved Instagram handle at no extra discovery cost. Instagram and Threads counts are rounded by Meta and the row carries both the rounded integer and the platform's own display string. Facebook is best effort: Meta serves a login wall to anonymous clients, so blocked is a normal answer there and never a zero. Read only; requires an APIFY_TOKEN and consumes Apify credits per call.
Quick start
Add this to your MCP client configuration:
{
"mcpServers": {
"mamba-meta-brand-presence-mapper": {
"command": "npx",
"args": ["-y", "@mambalabsdev/mcp-meta-brand-presence-mapper"],
"env": { "APIFY_TOKEN": "your-apify-token" }
}
}
}
Prerequisites
- Node.js 18 or newer
- An Apify API token from console.apify.com/account/integrations
The actor is pay per event and consumes Apify credits per call. Pricing is on the actor page.
Example prompts
- "Get the Instagram and Threads follower counts for glossier.com."
- "Has oatly.com adopted Threads yet, and how many posts do they have?"
- "Find the Facebook Page for everlane.com."
Tool and inputs
Tool: map_meta_brand_presence
| Input | Type | Meaning |
|---|---|---|
company_domain | string | Bare company domain, for example shopify.com. Supply this or a handle. With a domain the actor runs full discovery; with a handle it skips straight to the fetch. |
company_name | string | Optional. Improves search accuracy and is what the identity gate checks a discovered profile against, so supplying it reduces wrong matches. |
handle | string | Optional. The Instagram handle with or without the leading @. Supplying it skips Instagram discovery AND gives Threads its handle for free, because Threads handles are Instagram handles (5 of 5 measured). |
platforms | array | Which of the three Meta surfaces to map. Default is all three. Dropping Facebook is the common choice: it is the least reliable of the three and it costs a fetch to find that out. |
includeFollowerCounts | boolean | Default true: the profile page is fetched and the follower counts are extracted. Set false to resolve the profile URL only, which is cheaper and needs no proxy. |
skipCache | boolean | Default false: a successful lookup is cached for seven days and reused. Set true to force a fresh fetch. |
Reading the output
Every row carries a per platform _status field, and it is the field to read
first. The vocabulary is the same across the whole Mamba Labs social family:
| Status | Meaning |
|---|---|
ok | fetched and parsed, the value is there |
not_found | we looked and there is no such profile |
not_extractable | the profile exists and the value is not on the wire to us |
blocked | the platform refused us, worth retrying later |
identity_mismatch | we found a real profile and it belongs to someone else |
skipped | you did not ask for this platform |
false and null are never interchangeable. false means we looked and the
answer is no. null means we could not look. If you filter for companies with no
presence, filter on false, because null rows are unknown rather than absent.
Full actor documentation
apify.com/mambalabs/meta-brand-presence-mapper
Mamba Labs GTM Suite
Mamba Labs builds a fleet of GTM enrichment actors that share one flat, Clay
ready output convention, so their rows join on company_domain with no cleaning
step. Full fleet: apify.com/mambalabs
License
MIT