Skip to content

Competitors

Monitor competitor LinkedIn activity and engagement.

Full name: campaignstack_create_competitor_watch

competitors:write

Creates a new competitor watch to monitor a LinkedIn company page or influencer profile. Automatically deduplicates by normalized LinkedIn URL within the workspace. Use campaignstack_list_competitor_watches to see existing watches. Call this when the user names a company page or influencer to track ongoing. This is a different roster from the comparison-page list: campaignstack_search_console_set_competitor manages that one.

NameTypeRequiredDefaultDescription
workspaceIdstringNoWorkspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach.
profileUrlstringYes(min length: 1)
namestringYes(min length: 1)
entityTypecompany | influencerYes
accountIdsstring[]NoOptional LinkedIn account IDs the watch reads and acts with. Defaults to a single automatically chosen account, never all workspace accounts. Change later with campaignstack_update_competitor_watch_accounts.

Full name: campaignstack_list_competitor_watches

competitors:read Read-only Idempotent

Lists competitor watches for a workspace. Optionally filter by status (active/paused). Use campaignstack_get_competitor_watch to see post details for a specific watch. Call this when the user asks what is being tracked, or to find a watchId before pausing, resuming, or deleting one. It does not return the posts themselves.

NameTypeRequiredDefaultDescription
workspaceIdstringNoWorkspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach.
statusactive | pausedNoFilter by status. Omit to list all watches.

Full name: campaignstack_get_competitor_watch

competitors:read Read-only Idempotent

Returns a competitor watch with post count and the 5 latest posts. Use campaignstack_list_competitor_watches to find valid watch IDs. Call this when the user asks what a tracked competitor has posted lately. It returns only the 5 most recent posts, never the full history.

NameTypeRequiredDefaultDescription
watchIdstringYes(min length: 1)

Full name: campaignstack_delete_competitor_watch

competitors:write Destructive

Deletes a competitor watch and disables its associated automations. This action is irreversible. Use campaignstack_pause_competitor_watch to temporarily stop monitoring instead. Call this only when the user wants the watch gone for good, not just stopped for a while.

NameTypeRequiredDefaultDescription
watchIdstringYes(min length: 1)

Full name: campaignstack_pause_competitor_watch

competitors:write

Pauses a competitor watch and disables its associated automations. Use campaignstack_resume_competitor_watch to resume monitoring. Call this when the user wants tracking stopped for now but kept for later. Use campaignstack_delete_competitor_watch instead when they want it removed for good.

NameTypeRequiredDefaultDescription
watchIdstringYes(min length: 1)

Full name: campaignstack_resume_competitor_watch

competitors:write

Resumes a paused competitor watch and re-enables its associated automations. Use campaignstack_pause_competitor_watch to pause monitoring. Call this when the user wants a paused watch tracking again. It does not create a new watch: campaignstack_create_competitor_watch does that.

NameTypeRequiredDefaultDescription
watchIdstringYes(min length: 1)