Competitor intel
2 LinkedIn Ads tools, each with its inputs, hosted support and CLI command.
On this page
No CLI command or MCP tool launches a local browser or falls back to scraping when the API fails.
inspect_competitor_ads
LinkedIn AdsHosted, limitedDiscovers any company's ads through the official LinkedIn Ad Library API. In api mode it returns metadata only. In auto mode it also queues at most 10 ads on the optional remote creative worker for creative copy and screenshots, and returns cached results or job status. Supply both advertiser and companyId to filter broad name matches before creatives are queued.
Discover competitor ads through the official API. auto optionally queues up to 10 creatives on the remote worker; api returns metadata only. Always provide advertiser plus companyId to filter unrelated name matches before collection. No local browser or scraper fallback. Read pending results with get_competitor_creatives. Cached screenshots require worker authentication. Report sample coverage and collection dates; never retry a blocked worker or use another browser/client. Synthesize findings rather than dumping rows.
On the hosted endpoint: Returns Ad Library metadata only, unless the server is configured with the remote creative worker.
CLI
adwarp competitor ads <advertiser># any company's ads from the public Ad LibraryInputs 9
| Input | Type | What it is |
|---|---|---|
advertiser | string | Competitor/advertiser display name (accountOwner) |
companyId | string | Numeric LinkedIn company id, more precise than name |
keyword | string | Free-text keyword search across ad copy |
countries | string[] | ISO-3166 country codes to scope, e.g. ['US','GB'] |
max | integer = 50 | Max ads to collect |
engine | auto | api = "auto" | auto = official API plus remote creative worker; api = metadata only. Local scraping is disabled. |
deep | boolean = true | Enqueue up to 10 verified company ads on the remote worker; reuse cached creatives. |
concurrency | 1 = 1 | Remote worker concurrency is fixed at one. |
copyMax | integer = 10 | Creative sample size, capped at 10. Worker budgets cannot be overridden. |
get_competitor_creatives
LinkedIn AdsHostedReads completed remote creative jobs by ad id, without queuing new work.
Read remote creative job status and cached copy by ad IDs. Read-only: does not enqueue work or visit LinkedIn. Screenshots are available through the authenticated worker endpoint.
CLI
adwarp creative-status <ids># read remote creative jobs by comma-separated ad idInputs 1, 1 required
| Input | Type | What it is |
|---|---|---|
idsrequired | string[] |