`meta_ads_track_competitor`

Track Competitor

Description

Register a Meta advertiser for daily ad-library tracking. Provide exactly one identifier: page_id (numeric Facebook Page ID — most precise), page_url (a facebook.com page URL; numeric IDs resolve directly, vanity handles resolve by searching scraped advertisers), or name (searches scraped advertisers). A search resolving to exactly one advertiser tracks it; multiple matches return a candidate list (name, page_id, ad count) and track NOTHING — retry with page_id; zero matches return an error suggesting the page URL. Once tracked, the daily sweep scrapes the advertiser's ads into the corpus for meta_ads_list_competitor_ads. Requires no Meta connection.

Idempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_track_competitor",
    "arguments": {
      "page_id": "15087023444",
      "reason": "Start daily tracking of a key competitor"
    }
  }
}

hopkin meta track-competitor

Flag	Type	Required	Description
`--page-id`	`string`	Optional	Numeric Facebook Page ID of the advertiser (most precise identifier). A non-numeric value is treated as a handle/name search over scraped advertisers.
`--page-url`	`string`	Optional	Facebook Page URL, e.g. https://www.facebook.com/nike, https://www.facebook.com/profile.php?id=15087023444, or an Ad Library URL with view_all_page_id. Numeric IDs resolve exactly; vanity handles resolve by searching scraped advertisers.
`--name`	`string`	Optional	Advertiser name to search for among scraped advertisers, e.g. "Nike". Exactly one match is tracked; multiple matches return candidates and track nothing.

{
  "mcpServers": {
    "meta-ads": {
      "url": "https://meta.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (3)

Name	Type	Required	Description
`page_id`	`string`	Optional	Numeric Facebook Page ID of the advertiser (most precise identifier). A non-numeric value is treated as a handle/name search over scraped advertisers.minLength: 1
`page_url`	`string`	Optional	Facebook Page URL, e.g. https://www.facebook.com/nike, https://www.facebook.com/profile.php?id=15087023444, or an Ad Library URL with view_all_page_id. Numeric IDs resolve exactly; vanity handles resolve by searching scraped advertisers.
`name`	`string`	Optional	Advertiser name to search for among scraped advertisers, e.g. "Nike". Exactly one match is tracked; multiple matches return candidates and track nothing.minLength: 1

Examples

Track by page ID

{
  "page_id": "15087023444",
  "reason": "Start daily tracking of a key competitor"
}

hopkin meta track-competitor --page-id 15087023444

Track by page URL

{
  "page_url": "https://www.facebook.com/nike",
  "reason": "Track a competitor from their Facebook page link"
}

hopkin meta track-competitor --page-url https://www.facebook.com/nike

Track by name

{
  "name": "Nike",
  "reason": "Track a competitor known only by name"
}

hopkin meta track-competitor --name Nike