TraceeDocs

Tools

radar

Radar: social listening and signals

MCP tool

Social listening for this workspace, refreshed twice a day from X, Reddit, LinkedIn, TikTok, YouTube, Instagram and Hacker News. Trackers follow the brand, competitors (their accounts too) and topics. Finds are posts: what people say (mention) or a competitor's own post (post), each read for relevance, sentiment, worth_replying and a one-line gist. Signals are people who commented on those posts with a need, each with intent (question, complaint, comparison, interest, praise) and strength (3 = looking to buy or switch now).

Actions

overview

Start here. Trackers with followers and 7-day change, counts, the top things to act on, and competitors Radar found on its own from the company's domain (suggestions).

RESTGET/radar·CLItracee radar overview

findings

[tracker_id] [kind=mention|post] [only=reply|negative|positive] [days] [limit]

RESTGET/radar/findings·CLItracee radar findings

signals

signals [tracker_id] [intent] [min_strength] [status] [days] [limit]

Strongest first.

RESTGET/radar/signals·CLItracee radar signals

track

track kind=brand|competitor|topic name [keywords] [accounts] [networks]

Brand and topic need keywords (max 3); a competitor needs keywords or accounts. Runs a first check. Or track suggestion_id (from overview), or all_suggestions=true.

RESTPOST/radar/trackers·CLItracee radar track

discover

discover [domain]

Look for the company's competitors again (from its website or the given domain), in the background (about 20 seconds); they come back as suggestions in overview.

RESTPOST/radar/discover·CLItracee radar discover

update

update tracker_id [name] [keywords] [accounts] [networks] [enabled]

Also keeps a tracker that ran on its own for a new workspace's first day (those pause after it)

RESTPATCH/radar/trackers/{tracker_id}·CLItracee radar update <tracker_id>

refresh

refresh [tracker_id]

Check now in the background (a minute or two).

RESTPOST/radar/refresh·CLItracee radar refresh

mark

mark ids status=seen|saved|contacted|dismissed

Finds or signals.

RESTPOST/radar/mark·CLItracee radar mark

find_email

find_email signal_id

A LinkedIn commenter's work email, verified (costs a few cents; verify the verdict before writing).

RESTPOST/radar/signals/{signal_id}/find-email·CLItracee radar find-email <signal_id>

add_to_crm

add_to_crm signal_id [crm]

Becomes an approval request for a person; it creates the contact or lead once approved.

RESTPOST/radar/signals/{signal_id}/add-to-crm·CLItracee radar add-to-crm <signal_id>

dismiss

dismiss suggestion_id

Drop a competitor Radar suggested that isn't one.

RESTPOST/radar/suggestions/{suggestion_id}/dismiss·CLItracee radar dismiss <suggestion_id>

For one-off research beyond what's tracked (trends, keyword demand, lookalike companies, enrichment, competitors' ads, a live search) use the research tool.

To answer someone, draft the reply yourself from the find or signal; Tracee doesn't post replies or send messages.

Inputs

Every call takes action and the fields that action names above.

  • actionstringrequired

    What to do: overview, findings, signals, track, update, refresh, mark, find_email, add_to_crm, discover or dismiss. Each is described in the tool description.

    Available options:overviewfindingssignalstrackupdaterefreshmarkfind_emailadd_to_crmdiscoverdismiss

  • tracker_idstring

    From action=overview

    uuid

  • suggestion_idstring

    For track: a suggestion from action=overview

    uuid

  • all_suggestionsboolean

    For track: every suggestion at once

  • domainstring

    For discover: the company's website

    up to 200 characters

  • signal_idstring

    From action=signals

    uuid

  • idsstring[]

    Finds or signals, for mark. From radar action=findings or radar action=signals.

    up to 200 itemseach uuid

  • statusstring

    For mark and signals: the status.

    Available options:newseensavedcontacteddismissed

  • kindstring

    For track and findings: the kind.

    Available options:brandcompetitortopicmentionpost

  • onlystring

    For findings: the only.

    Available options:replynegativepositive

  • intentstring

    For signals: the intent.

    Available options:questioncomplaintcomparisoninterestpraiseother

  • min_strengthinteger

    For signals: the min strength.

    1–3

  • daysinteger

    For findings and signals: the days.

    1–90

  • limitinteger

    For findings and signals: the limit.

    1–100

  • namestring

    For track and update: the name.

    up to 80 characters

  • keywordsstring[]

    For track and update: the keywords.

    up to 3 itemseach up to 80 characters

  • accountsobject

    Profile link or @handle per network; LinkedIn and Facebook take the page link

  • networksstring[]

    For track and update: the networks.

    Available options:xredditlinkedintiktokyoutubeinstagramhackernews

  • enabledboolean

    For update: the enabled.

  • crmstring

    For add_to_crm: the crm.

    Available options:hubspotsalesforcepipedrive