add_channel
ChatGPTSave a channel and request a crawl when the user asks to add or refresh it. Creates a profile link if absent; reuses matching links. Eligible crawl jobs fetch public channel data and may replace stored analysis. Repeating a call can queue another crawl. Crawls consume available account usage credits and are skipped when scanning is inactive or credits are unavailable; the saved link remains. This tool does not purchase subscriptions or credits. Channels: linkedin, linkedin_person, twitter, instagram, tiktok, youtube, meta_ads, facebook_posts, website, google_ads. facebook_ads and meta alias meta_ads; facebook aliases facebook_posts. Social and ad channels require a matching profile URL; linkedin_person requires linkedin.com/in/..., twitter accepts twitter.com or x.com, and youtube accepts youtube.com or youtu.be. Omit url for website and google_ads; they use the competitor's website.
add_competitor
ChatGPTCreate a tracked company when the user requests adding it to a project. Saves a company record and starts website/profile discovery and favicon retrieval from its public website. Full scanning requires activation. kind=self sets the project's baseline if none exists; competitor is a rival; trendsetter is an inspiration source. Duplicate website hosts produce warnings but still create another record, so retrying can create duplicates. Uses existing account resources; does not purchase subscriptions or credits.
approve_battlecard
ChatGPTMark a rival's battlecard as approved by the caller.
generate_battlecard
ChatGPTGenerate a battlecard when the user requests creating or refreshing it. Sends stored competitor strategy, the project's baseline strategy if present, and open deviations to the configured AI service. Saves the initial card; later runs preserve existing content and add pending suggestions for review. Requires activated scanning and existing analysed data. Rejects concurrent generation; later retries may create additional suggestions. Uses existing account AI resources and does not purchase subscriptions or credits.
get_battlecard
ChatGPTThe team's sales battlecard for one rival. Returns content (null until one is generated), pending suggestions with their ids and evidence, approval state, and whether generation is running.
get_item
ChatGPTFull stored row, current profile, or snapshot series. kind is post, ad, page, profile, or snapshots. item_id is required for post/ad/page. Profiles and snapshots omit item_id; snapshots honor window_days.
list_events
ChatGPTPersisted deviations or strategy versions, newest first, cursor-paged. Prefer kind=deviation (playbook-break events with evidence). kind=strategy_version is a historical dump of Spiderlook's stored LLM writeup — skip it unless the user asks for that history. status applies only to deviations.
list_workspace
ChatGPTCatalog of orgs, projects, and competitors the user can access. Use when project or competitor IDs are unknown. Each competitor includes kind (self|competitor|trendsetter) and is_self.
query_activity
ChatGPTScraped posts, ads, or pages for one channel, windowed and newest first. Primary evidence tool. Read these items and form your own answer; do not look up Spiderlook's stored channel-strategy writeup. Instagram feed vs reels is variant=feed|reel|all, not a separate channel. window_days is clamped to 1..90 (default 30).
query_metrics
ChatGPTBatched project counts and named formulas. Not a dashboard narrative. Valid metrics: relative_activity_index, activity_threat, activity_counts, ad_launches, ad_counts, follower_totals, talent_velocity, open_deviations, strategy_shifts, weekly_kpi_series. Prefer counts and formulas; weekly_kpi_series is the uniform competitor×week×channel history surface. strategy_shifts is analyzer text the app already shows. Do not N+1 query_activity to rebuild rankings. window_days is clamped to 1..90 (default 30).
report_missing_capability
ChatGPTRecord feedback about a Spiderlook capability unavailable in the listed tools when it prevents completing the user's Spiderlook request. Sends feedback to the developers through PostHog; does not discover or enable additional tools.
review_battlecard_suggestion
ChatGPTAccept or dismiss one pending battlecard suggestion. Use when the user requests accepting or dismissing a specific suggestion. Accepting may add or replace existing card content and marks the suggestion accepted. Dismissing marks it dismissed without changing card content. suggestion_id comes from get_battlecard pending_suggestions. A suggestion that has already been reviewed is rejected without further changes.
update_competitor
ChatGPTRe-label kind (competitor ↔ trendsetter) or toggle continuous_tracking. Do not use kind=self here — promote baselines via the product self-competitor flow. Active baselines cannot be re-labeled until cleared.
add_channel
Claudeadd_competitor
Claudeapprove_battlecard
Claudegenerate_battlecard
Claudeget_battlecard
Claudeget_item
Claudelist_events
Claudelist_workspace
Claudequery_activity
Claudequery_metrics
Claudereport_missing_capability
Claudereview_battlecard_suggestion
Claudeupdate_competitor
Claude