accueil / serveurs / Recherche & Web / dev.rumoro/mcp
dev.rumoro/mcp
serveur MCP (Model Context Protocol) · rumoro-mcp 0.1.0
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que dev.rumoro/mcp est sûr ?
Au dernier audit MCP Hub, le serveur MCP « dev.rumoro/mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 57 outils
- add_keyword≈ 2522 tokens
Creates a keyword to track. kind is "brand" (default), "competitor" or "topic". platforms limits where it runs, all by default. New posts with the term are matched, classified and delivered. To narrow a common word, set `matching` (requiredTerms with requiredMode any or all, excludedTerms with a `*` wildcard at either end, excludedAuthors, caseSensitive). Rejected posts are never stored or billed. `context` is one sentence for this keyword's classifier, such as "Basil is our deploy tool, not the herb." `cap` ({ mentions: N }) sets a monthly limit on matches. A capped keyword stops matching until the 1st (UTC) or a higher cap, and is still charged daily. `groupId` picks a group from list_groups, otherwise the default group. A term can exist once per group. `reviewSources` adds review pages, each as a url (App Store or Google Play app, Trustpilot page, Google Maps place or maps.app.goo.gl link) or a platform (appstore, googleplay, trustpilot, googlemaps) and id. App stores also take countries (two-letter, default us), and Google Play a language (default en). Every review becomes a mention, pages are read daily, and the last 30 days (up to 100 reviews) arrive free at once. `feeds` reads RSS or Atom feeds, each as { url }: a feed's address, or a page's (a forum, a community, a blog) whose advertised feed is used; an address with no feed is refused. An item is a mention when it holds the term, feeds are read every hour, and the newest 10 matching items of the last 30 days arrive at once, billed like any mention. `platforms: []` makes a reviews-only or feeds-only keyword. `comments` ({ enabled: true, maxPerPost: N }, off by default) reads the comments under its relevant mentions from 30 minutes after each post while its platform's conversations last, at most maxPerPost (default 20) per mention, $0.008 per comment delivered; list them with list_mention_comments.
Paramètres, retour & exemple (10)
Paramètrescap· ? · optionnel
Monthly limit on matched mentions. Omit or null means none.kind· string · optionnel · brand | competitor | topic
brand is for your own names, competitor for a rival's, and topic for your market. Share of voice and segments use it.term· string · requis
The word or phrase to monitor. It matches as a whole phrase, ignoring case.feeds· array · optionnel
RSS or Atom feeds this keyword reads, at most 20, each { url }: a feed's address, or a page's (a forum, a community, a blog), whose advertised feed is used, else a usual address such as /feed or /rss. Every feed is checked when saved, and a 400 names each one that cannot be read and why. Feeds are read every hour; an item is a mention of this keyword when it holds the term (with its matching rules), and only of keywords that named the feed. A newly connected feed brings its newest 10 matching items of the last 30 days, billed like any mention. On PATCH the list replaces the old one, and [] disconnects them all (their mentions stay).context· ? · optionnel
Up to 300 characters the classifier reads for this keyword only, in addition to the company profile or the group's description. Say what the term means for you and what to ignore, for example "Basil is our deploy tool, not the herb." Null clears it.groupId· string · optionnel
The group to put it in (grp_...). Without it, the workspace's default group is used. Each group can hold a term only once.comments· object · optionnel
Comments under this keyword's mentions; omitted fields stay as they are (on create: off, 20 per mention).matching· object · optionnel
Fields you leave out stay as they are. An empty list clears a field.platforms· ? · optionnel
The platforms to search for the term. Leave it out or send null for all platforms. An empty list searches nowhere, for a keyword that only collects reviews and so needs reviewSources.reviewSources· array · optionnel
Review pages for this keyword, at most 10 (App Store and Google Play apps, Trustpilot pages, Google Maps places). Every new review on them is a mention, whatever it says. Pages are read daily, per country on the app stores. A newly added page imports its last 30 days, up to 100 newest reviews per country, free and without instant alerts. Later reviews are billed like other mentions.
Exemple d'appel{"name": "add_keyword", "arguments": {"term": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - create_alert≈ 3662 tokens
Creates an alert. mode "instant" sends each matching mention as it arrives. "hourly" sends a digest of the previous UTC hour at five past, skips hours with no mention above the minimum, and takes no schedule and no email channel (only Slack, Telegram and webhooks). "daily" sends one digest at schedule.hour in schedule.timezone. "weekly" sends one a week on schedule.weekday, from 0 for Sunday to 6 for Saturday. filter can use keywordIds, platforms, minRelevance, minConfidence, sentiments, intents, excludeAuthors, minFollowers, tags and linkHosts (hosts a post links to, including subdomains). Without minRelevance only relevant mentions (40 and up) are sent, and 0 sends every scored match, noise included. channelIds come from list_channels.
Paramètres, retour & exemple (7)
Paramètresmode· string · optionnel · instant | hourly | daily | weeklyname· string · requisevent· ? · optionnel
Custom webhook event name. Null keeps the mode's default.filter· object · optionnelenabled· boolean · optionnelschedule· object · optionnel
Daily and weekly alerts need it, and weekly ones need schedule.weekday too. Hourly alerts send every UTC hour, ignore a time or zone, and reject a weekday.channelIds· array · optionnel
Where to send, as ids from GET /v1/channels.
Exemple d'appel{"name": "create_alert", "arguments": {"name": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - create_group≈ 596 tokens
Creates a keyword group with a name that is unique in the workspace. You can add externalId, your own unique id such as a client id. You can also add context, a company description saying who the business is, what it sells and to whom. The classifier reads it instead of the whole workspace profile, guidelines and competitors included, for this group's keywords, so put any group rule in that text. An agency can make one group per client with the client's description, so each client's mentions are scored for that client. Then pass the group's id as groupId to add_keyword.
Paramètres, retour & exemple (3)
Paramètresname· string · requis
The group's name, such as a client, campaign or product. Must be unique in the workspace.context· ? · optionnel
Up to 4000 characters the classifier treats as "the company" for this group's keywords. It fully replaces the workspace profile, including its relevance guidelines and competitors. Describe the business, what it sells and to whom, what it is not, and any rule for this group, such as "ignore job posts". With one group per client, use the client's description. Null means the workspace profile is used.externalId· ? · optionnel
An id from your own system, such as a client id. Must be unique in the workspace. Find the group with GET /v1/groups?externalId=.
Exemple d'appel{"name": "create_group", "arguments": {"name": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - create_segment≈ 1120 tokens
Saves an audience segment with a name and a filter. The filter can use platforms, tags, follower range, minimum mentions or negative mentions, intents, keyword kinds the person did or did not mention, first seen within N days, and linkHosts they linked to. Members are worked out on each read, not stored.
Paramètres, retour & exemple (3)
Paramètresname· string · requisfilter· object · optionneldescription· string · optionnel
Exemple d'appel{"name": "create_segment", "arguments": {"name": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - create_view≈ 3930 tokens
Saves a view with a name and a filter. The filter uses the fields of search_mentions, such as keywords or keyword kinds, platforms, status, relevant, sentiments, intents, languages, author tags, follower range, replies, link hosts, automated and free text. A list matches any value, a `not` list matches none, and all conditions are joined by AND. anyOf adds OR with groups of such conditions, at least one of which must match. Nothing is stored ahead of time, so the view shows whatever matches when read.
Paramètres, retour & exemple (3)
Paramètresname· string · requis
Must be unique in the workspace, ignoring case.filter· object · optionnel
The view's filter. Empty means all mentions.description· string · optionnel
The view's purpose, shown below its name.
Exemple d'appel{"name": "create_view", "arguments": {"name": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_activity≈ 158 tokens
Deletes an outreach activity that was logged by mistake. The person keeps the same owner and stage.
Paramètres, retour & exemple (2)
Paramètresid· string · requis
The person's id (aut_...)activityId· string · requis
The activity's id (act_...) from list_activities
Exemple d'appel{"name": "delete_activity", "arguments": {"id": "texte", "activityId": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_alert≈ 139 tokens
Deletes an alert. Its channels remain and other alerts can use them. This cannot be undone. To keep the alert, disable it with update_alert enabled=false instead.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The alert's id (feed_...)
Exemple d'appel{"name": "delete_alert", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_group≈ 144 tokens
Deletes a keyword group and all of its keywords, each as delete_keyword would, mentions included. The default group cannot be deleted. The answer says how many keywords were deleted.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The group's id (grp_...)
Exemple d'appel{"name": "delete_group", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_keyword≈ 177 tokens
Stops monitoring a keyword and deletes its mentions, but keeps a post that another keyword also matched. Alerts that named it drop it, and an alert that named only this keyword is disabled instead of widening to all keywords. This cannot be undone. Muting with update_keyword muted=true keeps the mentions.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The keyword's id (kw_...)
Exemple d'appel{"name": "delete_keyword", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_segment≈ 120 tokens
Deletes a saved segment. The people in it are not changed.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The segment's id (seg_...) from list_segments
Exemple d'appel{"name": "delete_segment", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_view≈ 111 tokens
Deletes a saved view and leaves its mentions untouched.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The view's id (vw_...)
Exemple d'appel{"name": "delete_view", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - dismiss_attention≈ 132 tokens
Moves an attention item (att_... from list_attention) out of the open list for as long as its condition lasts.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The attention item's id (att_...)
Exemple d'appel{"name": "dismiss_attention", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - duplicate_keyword≈ 390 tokens
Creates a new keyword with an existing keyword's settings. Give the new term, or the same term with another groupId, since a group tracks a term once. It copies the kind, platforms, context, every matching rule, the monthly mention cap and the comments setting. Review pages and feeds are copied only when listed in include (reviewSources, feeds), because two keywords on one page collect and bill every review twice. The copy is a new keyword: $5 a month, and its last 30 days come in at once.
Paramètres, retour & exemple (4)
Paramètresid· string · requis
The keyword to copy (kw_...).term· string · requis
The copy's term. The original's term is allowed only in another group (groupId), since a group tracks a term once.groupId· string · optionnel
The copy's group (grp_...). Omitted, it joins the original's group.include· array · optionnel
Also copy these: reviewSources (its review pages) and feeds (its RSS or Atom feeds). Off by default, because two keywords on one page or feed collect, and bill, every review or item twice.
Exemple d'appel{"name": "duplicate_keyword", "arguments": {"id": "texte", "term": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_alert≈ 121 tokens
Fetches an alert by id. Includes delivery stats as well as its filter, mode, schedule and channels.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The alert's id (feed_...)
Exemple d'appel{"name": "get_alert", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_analytics_breakdown≈ 670 tokens
Returns a table grouped by `by`. That is platform, keyword, sentiment, intent, status (open, ignored, done), hour (weekday and hour in timezone, to see when people post) or person (the most active authors, with followers). Each row has matched, relevant, its percentage of the period, a sentiment split and, with compare=true, the same row for the period just before. The period works as in get_analytics_summary. Up to 50 rows, the one with the most matches first.
Paramètres, retour & exemple (8)
Paramètresby· string · requis · platform | keyword | sentiment | intent | status | hour | person | language
How to group the rows. platform, keyword, sentiment (unclassified included), intent (a mention can have several), status (open, ignored, done), hour (weekday and hour in `timezone`), person (the author, without anonymous posts) or language (ISO 639-1, or "unknown" when there is none).to· string · optionnel
End date in `timezone`, as YYYY-MM-DD, included. Defaults to today.from· string · optionnel
Start date in `timezone`, as YYYY-MM-DD. That day is included.range· string · optionnel · 7d | 30d | 90d | 365d
A preset period up to today, 30d by default. Ignored when you send from or to.compare· boolean · optionnel
true adds the equally long period just before as `previous`.timezone· string · optionnel
The IANA time zone used to split days, such as America/New_York. Defaults to UTC. The zone's offset at the end of the period is used for the whole period.platforms· array · optionnel
Keeps these platforms only. Repeat the parameter or separate values with commas. Leave it out for all platforms.keywordIds· array · optionnel
Keeps these keyword ids only. Repeat the parameter or separate values with commas. Leave it out for all keywords.
Exemple d'appel{"name": "get_analytics_breakdown", "arguments": {"by": "platform"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_analytics_series≈ 659 tokens
Counts matched, relevant and sentiment mentions per day or week (bucket, days by default up to 90 days). Returns one "total" series, or splits by="platform" or by="keyword" (top 20, rest as "other"). Period options match get_analytics_summary. compare=true adds `previous`, the prior period, aligned by index.
Paramètres, retour & exemple (9)
Paramètresby· string · optionnel · platform | keyword | sentiment
Splits the data into a series for each platform, each keyword or each sentiment (positive, neutral, negative, unclassified). By keyword you get the top 20 by matches, with the rest combined as "other". Leave it out for one total series.to· string · optionnel
End date in `timezone`, as YYYY-MM-DD, included. Defaults to today.from· string · optionnel
Start date in `timezone`, as YYYY-MM-DD. That day is included.range· string · optionnel · 7d | 30d | 90d | 365d
A preset period up to today, 30d by default. Ignored when you send from or to.bucket· string · optionnel · hour | day | week | month
The size of each point. hour for periods up to 14 days, day, week (starting Monday) or month. By default days up to 90 days and weeks beyond.compare· boolean · optionnel
true adds the equally long period just before as `previous`.timezone· string · optionnel
The IANA time zone used to split days, such as America/New_York. Defaults to UTC. The zone's offset at the end of the period is used for the whole period.platforms· array · optionnel
Keeps these platforms only. Repeat the parameter or separate values with commas. Leave it out for all platforms.keywordIds· array · optionnel
Keeps these keyword ids only. Repeat the parameter or separate values with commas. Leave it out for all keywords.
Exemple d'appel{"name": "get_analytics_series", "arguments": {"by": "platform", "to": "texte", "from": "texte", "range": "7d", "bucket": "hour", "compare": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_analytics_summary≈ 578 tokens
Returns summary counts for a period. Covers matched and relevant mentions, unique posts and people, sentiment, buying intent, questions, reach and triage. Reach sums followers where known. Triage gives open, ignored and done counts, mentions waiting over 24h, handled rate and median time to done. Set the period with range (7d, 30d, 90d or 365d, ending today) or from and to (YYYY-MM-DD). keywordIds and platforms take lists. timezone (IANA, default UTC) sets day boundaries. compare=true adds the prior period as `previous`. Dates are publish dates.
Paramètres, retour & exemple (7)
Paramètresto· string · optionnel
End date in `timezone`, as YYYY-MM-DD, included. Defaults to today.from· string · optionnel
Start date in `timezone`, as YYYY-MM-DD. That day is included.range· string · optionnel · 7d | 30d | 90d | 365d
A preset period up to today, 30d by default. Ignored when you send from or to.compare· boolean · optionnel
true adds the equally long period just before as `previous`.timezone· string · optionnel
The IANA time zone used to split days, such as America/New_York. Defaults to UTC. The zone's offset at the end of the period is used for the whole period.platforms· array · optionnel
Keeps these platforms only. Repeat the parameter or separate values with commas. Leave it out for all platforms.keywordIds· array · optionnel
Keeps these keyword ids only. Repeat the parameter or separate values with commas. Leave it out for all keywords.
Exemple d'appel{"name": "get_analytics_summary", "arguments": {"to": "texte", "from": "texte", "range": "7d", "compare": true, "timezone": "texte", "platforms": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_company≈ 133 tokens
Returns the company profile the classifier reads, with name, description, use cases, own accounts and the context text built from them for relevance scoring. A group with its own description replaces that text for its keywords (see list_groups).
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_company", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_filters≈ 139 tokens
Returns the workspace noise rules that run before any mention is stored, for every keyword. They exclude terms, authors and GitHub repositories, and allow or block subreddits. Rejected posts are never classified, sent or billed. Keywords add their own `matching` rules.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_filters", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_group≈ 111 tokens
Returns a keyword group by id, with its number of keywords.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The group's id (grp_...)
Exemple d'appel{"name": "get_group", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_keyword≈ 140 tokens
Fetches a keyword by id. Returns its setup (term, kind, platforms, matching rules, context, monthly cap, pausedForCap), its stats and how polling goes on each platform.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The keyword's id (kw_...)
Exemple d'appel{"name": "get_keyword", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_keyword_health≈ 361 tokens
Checks whether a keyword earns its cost, over range 7d, 30d or 90d (default 30d). Returns a status with plain-word reasons. noisy is 20+ scored matches with under 30% relevant, quiet is 7+ days old with nothing relevant, new is under 7 days old, and the rest are healthy, capped or paused. Also returns matches, relevant and noise share by platform and week, cost, the words and authors behind the noise, and suggestions. To apply one, pass its `patch` and the keyword id to update_keyword (lists replace the whole list). Its `effect` shows the noise and relevant matches and the cents the matcher's rules say it would have removed in the period. ai=true adds a model-written context (cached a day, 20 calls an hour per workspace). Read only, never billed, cached 5 minutes.
Paramètres, retour & exemple (3)
Paramètresai· boolean · optionnel
true also asks a language model to rewrite the context. False by default.id· string · requis
The keyword's id (kw_...)range· string · optionnel · 7d | 30d | 90d
How far back from today to read. 7d, 30d (the default) or 90d.
Exemple d'appel{"name": "get_keyword_health", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_mention≈ 124 tokens
Fetches one mention, classification included (relevance, sentiment, intents, confidence, uncertain, note).
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The mention's id (mm_...)
Exemple d'appel{"name": "get_mention", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_mention_stats≈ 254 tokens
Returns mention counts for the past N days (7 by default), by platform and by sentiment. You can limit it to one platform or keyword. Mentions without a score are counted under the sentiment "unclassified".
Paramètres, retour & exemple (3)
Paramètresplatform· string · optionnel · bluesky | hackernews | github | stackoverflow | devto | reddit | x | youtube
Counts only this platform's mentionskeywordId· string · optionnel
Counts only the mentions of this keyword idsinceDays· integer · optionnel
How many days back to count
Exemple d'appel{"name": "get_mention_stats", "arguments": {"platform": "bluesky", "keywordId": "texte", "sinceDays": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_person≈ 198 tokens
Returns one person from your audience with their counts, your tags, notes and mute, and their outreach status (owner, stage, last contacted). It also has their public profile where the platform shows one, with bio, company, location, website and linked accounts. profile.email is always null here. GitHub authors are looked up the same day, and profile is null until then.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The aut_... id from list_people, or author.id on a mention
Exemple d'appel{"name": "get_person", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_reviews_report≈ 584 tokens
Reports on the reviews your keywords collect from the App Store, Google Play, Trustpilot and Google over a period. Includes totals (reviews, average stars, star distribution, replies, open 1 and 2 star reviews), tags from unhappy reviews, and each review page's average stars per day or week (bucket). Two keywords matching one review count it once. Period options match get_analytics_summary, and compare=true adds the prior period.
Paramètres, retour & exemple (8)
Paramètresto· string · optionnel
End date in `timezone`, as YYYY-MM-DD, included. Defaults to today.from· string · optionnel
Start date in `timezone`, as YYYY-MM-DD. That day is included.range· string · optionnel · 7d | 30d | 90d | 365d
A preset period up to today, 30d by default. Ignored when you send from or to.bucket· string · optionnel · day | week
The step of each series, day or week. Days by default for periods up to 90 days.compare· boolean · optionnel
true adds the equally long period just before as `previous`.timezone· string · optionnel
The IANA time zone used to split days, such as America/New_York. Defaults to UTC. The zone's offset at the end of the period is used for the whole period.platforms· array · optionnel
Keeps these platforms only. Repeat the parameter or separate values with commas. Leave it out for all platforms.keywordIds· array · optionnel
Keeps these keyword ids only. Repeat the parameter or separate values with commas. Leave it out for all keywords.
Exemple d'appel{"name": "get_reviews_report", "arguments": {"to": "texte", "from": "texte", "range": "7d", "bucket": "day", "compare": true, "timezone": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_share_of_voice≈ 527 tokens
Compares your brand with competitors. Returns each keyword with matches in the period, with matched, relevant, negative and buy-intent counts and its percentage of all brand and competitor matches. Topics are counted but not part of the split. The period works as in get_analytics_summary. compare=true adds each keyword's matches for the period just before.
Paramètres, retour & exemple (7)
Paramètresto· string · optionnel
End date in `timezone`, as YYYY-MM-DD, included. Defaults to today.from· string · optionnel
Start date in `timezone`, as YYYY-MM-DD. That day is included.range· string · optionnel · 7d | 30d | 90d | 365d
A preset period up to today, 30d by default. Ignored when you send from or to.compare· boolean · optionnel
true adds the equally long period just before as `previous`.timezone· string · optionnel
The IANA time zone used to split days, such as America/New_York. Defaults to UTC. The zone's offset at the end of the period is used for the whole period.platforms· array · optionnel
Keeps these platforms only. Repeat the parameter or separate values with commas. Leave it out for all platforms.keywordIds· array · optionnel
Keeps these keyword ids only. Repeat the parameter or separate values with commas. Leave it out for all keywords.
Exemple d'appel{"name": "get_share_of_voice", "arguments": {"to": "texte", "from": "texte", "range": "7d", "compare": true, "timezone": "texte", "platforms": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_usage≈ 149 tokens
Shows whether tracking is stopped or the balance is low, with the prepaid balance (ledger, pending mention charges, effective), daily spend and days left, running and balance-paused keywords, and matches today and over 30 days. Pricing is $0.008 per matched mention and $5 a month per active keyword, charged daily.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_usage", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_usage_breakdown≈ 518 tokens
Usage and charges for a period in US cents at list price, grouped by one `by` per call. keyword (default) gives days charged, mentions billed and totalCents per keyword, with deleted keywords marked keyword.removed=true. platform and day also work. Pick a trailing `range` (7d, 30d or 90d, default 30d) or a calendar `month` (YYYY-MM), which matches a bill or a per-client margin. Every call includes totals (keyword-days, matched and billed mentions, list-price total, actual ledger debits). Rows are paged (limit, offset, total). Use it for "what did keyword X cost". get_usage tells how much is left, and get_keyword has each keyword's month-to-date cost as stats.cost.
Paramètres, retour & exemple (5)
Paramètresby· string · optionnel · day | platform | keyword | group
How to group the rows. day gives one row per UTC day, then platform, keyword (the default, used to work out margins), or group (the cost of a client or campaign).limit· integer · optionnel
How many rows to return, from 1 to 500, 100 by default. Only by=keyword can need more than one page, since a period has at most 90 days and there are only a dozen platforms.month· string · optionnel
A calendar month (YYYY-MM, UTC) to read instead of a range. It covers the month's first to last day, or up to today for the current month. A future month returns 400.range· string · optionnel · 7d | 30d | 90d
How many UTC days back from today to read. One of 7d, 30d or 90d, 30d by default. Ignored when you send `month`.offset· integer · optionnel
How many rows to skip.
Exemple d'appel{"name": "get_usage_breakdown", "arguments": {"by": "day", "limit": 1, "month": "texte", "range": "7d", "offset": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_activities≈ 183 tokens
Shows who on the team has contacted a person, latest first. Each entry has the member, the channel, the time and a note. Channels are email, x, linkedin, bluesky, reddit, github, call, meeting and other. Look at this and the outreach owner before contacting someone, so teammates don't double up.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The aut_... id from list_people, or author.id on a mention
Exemple d'appel{"name": "list_activities", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_alerts≈ 104 tokens
Returns every alert with its filter, mode, schedule and channels. The mode is instant, or hourly, daily or weekly for a digest.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_alerts", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_attention≈ 388 tokens
Lists items that need a person, latest first. Kinds are mention.spike (mentions jumped in the last hour), sentiment.negative_spike (24-hour negative share jumped), keyword.noisy (turned noisy) and channel.failing (recent sends all failed). Checks run hourly, and items resolve when the condition ends. Open items by default, and status "all" adds the history. Items have a one-line title, numbers in data, and data.url to the dashboard.
Paramètres, retour & exemple (4)
Paramètreskinds· array · optionnel
Keeps these kinds only.limit· integer · optionnel
Number of items, 50 if omitted.cursor· string · optionnel
The nextCursor of the previous call.status· string · optionnel · open | resolved | dismissed | all
Which items to list. Defaults to open.
Exemple d'appel{"name": "list_attention", "arguments": {"kinds": [], "limit": 1, "cursor": "texte", "status": "open"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_channels≈ 115 tokens
Lists alert destinations (Slack channels, Telegram chats, email lists, webhooks). Connect Telegram chats in the dashboard under Settings, Integrations. The API can't.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_channels", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_groups≈ 181 tokens
Lists the workspace's keyword groups, the default first. Groups organize keywords, for example by client, campaign or product. Every keyword is in one group, a group can hold a term once, and get_usage_breakdown with by=group shows each group's cost. externalId finds the group with your own id.
Paramètres, retour & exemple (1)
ParamètresexternalId· string · optionnel
Filters to the one group whose externalId matches exactly.
Exemple d'appel{"name": "list_groups", "arguments": {"externalId": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_keywords≈ 831 tokens
Lists the workspace's keywords with stats, polling status, matching rules and context, plus `total`. With no arguments you get all keywords, latest first. q searches the term and context. You can filter by kind, status (active, muted by someone, paused for balance, noisy when the noise brake paused it, or capped at its monthly mention cap), platform or groupId, order with sort, and page with limit and offset.
Paramètres, retour & exemple (8)
Paramètresq· string · optionnel
Case-insensitive search in the term and context.kind· array · optionnel
Keeps keywords of these kinds only (brand, competitor, topic). Repeat the parameter or separate values with commas.sort· string · optionnel · newest | oldest | term | mentions | relevant | recent | lastMention
newest puts the latest created first and oldest the earliest. term sorts A to Z. mentions puts the most matches first and relevant the most relevant matches. recent puts the most matches of the past 7 days first. lastMention puts the latest matched post first, with keywords that have none at the end.limit· integer · optionnel
How many to return, from 1 to 500. Leave it out to get all keywords after `offset`.offset· integer · optionnel
How many keywords to skip.status· array · optionnel
Keeps keywords in these states only (active, muted, paused, capped). Repeat the parameter or separate values with commas.groupId· array · optionnel
Keeps keywords in these groups only (grp_...). Repeat the parameter or separate values with commas.platform· array · optionnel
Keeps keywords that run on one of these platforms. That means the term is searched there, which is every platform when platforms is null. For appstore and googleplay it means an app from that store is in reviewSources. Repeat the parameter or separate values with commas.
Exemple d'appel{"name": "list_keywords", "arguments": {"q": "texte", "kind": [], "sort": "newest", "limit": 1, "offset": 1, "status": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_ledger≈ 208 tokens
Shows the prepaid balance's history, latest first. Entries cover the welcome credit, top-ups, refunds, adjustments, and the daily keyword-day and mention debits. Debits carry their UTC settlement day and cumulative units. Cursor pages, limit up to 100. Funds are added on the dashboard's billing page or with POST /v1/billing/top-ups.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
How many to return, 25 by default.cursor· string · optionnel
The cursor of the previous page. Do not parse it.
Exemple d'appel{"name": "list_ledger", "arguments": {"limit": 1, "cursor": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_members≈ 113 tokens
Lists workspace members with their role (owner, admin, member), email and user id. Use the user id for assigneeId in update_mention and ownerId in update_person.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_members", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_mention_comments≈ 228 tokens
The comments under a mention's post, newest first, whether or not each names your keyword, with a light sentiment and intent read and mentionId when a comment is itself one of your mentions. Filled for new relevant mentions of keywords with comments on, from 30 minutes after the post.
Paramètres, retour & exemple (3)
Paramètresid· string · requis
Mention id (mm_...)limit· integer · optionnel
Page size, 1 to 100.cursor· string · optionnel
nextCursor from the previous page.
Exemple d'appel{"name": "list_mention_comments", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_people≈ 1276 tokens
Lists the authors of mentions of your keywords. Each has name, profile, platform, how many posts matched and how many scored relevant, sentiment split, first and last seen, and outreach status (owner, stage, last contacted). You can filter by platform or name, find one person by handle or profile link (handle), and filter by outreach stage (stages), owner (ownerIds, or "none" for no owner) or automated (bots whose posts are mostly machine-made). Sort by mentions or by recency. To read what one person said, use search_mentions with personId.
Paramètres, retour & exemple (24)
Paramètresq· string · optionnel
Searches the display name, handle and profile linktag· string · optionnel
Keeps people with this tagsort· string · optionnel · mentions | recent | reach | new
"mentions" puts the most matches first, "recent" the most recently seen, "reach" the most followers, and "new" people seen for the first time most recentlytags· array · optionnel
Keeps people with one of these tagslimit· integer · optionnelmuted· boolean · optionnel
true keeps muted people and false people who are not muted. Leave it out for everyonesince· integer · optionnel
Keeps people whose first matched mention is at this time or later, as ISO 8601 or epoch ms. Use it to find new voiceshandle· string · optionnel
Looks up one person by an account, given as a handle (@sam, u/sam) or a profile or post link (https://x.com/sam). The match is exact but ignores case. Add platform to pick one platformoffset· integer · optionnel
How many people to skip, for pagingstages· array · optionnel
Only people in one of these outreach stagesintents· array · optionnel
Has a mention tagged with one of these intentsownerIds· array · optionnel
Keeps people owned by one of these members, by user id. Use "none" for people without an ownerplatform· string · optionnel · bluesky | hackernews | github | stackoverflow | devto | reddit | x | youtube
Only people with a profile on this platformautomated· boolean · optionnel
true keeps people whose matched posts are mostly machine-made, such as bots. false keeps the otherslinkHosts· array · optionnel
Keeps people with a mention that links to one of these hosts or its subdomains, so slack.com also matches api.slack.complatforms· array · optionnel
Keeps people with an account on one of these platformssegmentId· string · optionnel
Adds a saved segment's filter (from list_segments) to the other filtersminMentions· integer · optionnel
Minimum number of matched mentionsminNegative· integer · optionnel
Minimum number of negative mentionskeywordKinds· array · optionnel
Keeps people who mentioned a keyword of one of these kinds (brand, competitor, topic)maxFollowers· integer · optionnelminFollowers· integer · optionnel
Keeps people with this many followers or more. Unknown counts are left outnewSinceDays· integer · optionnel
Keeps people first seen in the past this many daysneverKeywordKinds· array · optionnel
Excludes people who mentioned these keyword kinds
Exemple d'appel{"name": "list_people", "arguments": {"q": "texte", "tag": "texte", "sort": "mentions", "tags": [], "limit": 1, "muted": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_segments≈ 142 tokens
Lists your saved audience segments, which are named people filters such as "Large accounts" or "Open to switching", with the current number of people in each. Also returns presets you can save with create_segment. To see who is in a segment, pass its id to list_people.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_segments", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_views≈ 115 tokens
Lists your saved views, which are named mention filters such as "Bug reports" or "Waiting on us". Pass a view's id as viewId to search_mentions to get exactly what it shows.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_views", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - log_activity≈ 382 tokens
Logs that someone on the team contacted a person, for example by email, direct message or call. A not_contacted person moves to contacted, and a person with no owner gets the contacting member as owner. A later stage or an existing owner stays, and update_person changes them. memberId falls back to the signed-in user. Called with an API key and no memberId, it logs an activity without a member and sets no owner. Returns the new activity and the updated person.
Paramètres, retour & exemple (5)
Paramètresid· string · requis
The aut_... id from list_people, or author.id on a mentionnote· string · optionnel
A short summary of what was sent or said.channel· string · requis · email | x | linkedin | bluesky | reddit | github | call | meeting
How the person was contacted.memberId· string · optionnel
The user id of the member who reached out. Defaults to the signed-in member. With an API key and no value, the activity has no member.occurredAt· integer · optionnel
Defaults to now. Otherwise send the contact time as ISO 8601 or epoch ms.
Exemple d'appel{"name": "log_activity", "arguments": {"id": "texte", "channel": "email"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - merge_people≈ 180 tokens
Tells your workspace that two accounts are the same individual by merging account `id` into person `into`. Their mentions, tags and notes are combined, and the merged account appears among the person's platforms.
Paramètres, retour & exemple (2)
Paramètresid· string · requis
The account to merge (aut_...)into· string · requis
The person to merge it into (aut_...)
Exemple d'appel{"name": "merge_people", "arguments": {"id": "texte", "into": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - mute_authors≈ 283 tokens
Adds authors to an alert's muted list and keeps the rest of the filter. Entries can be profile or post links, @handles, u/names, Bluesky DIDs or display names. Links are stored as the author's profile. Authors already on the list are skipped, and entries that don't name a person are refused.
Paramètres, retour & exemple (2)
Paramètresid· string · requis
The alert's idauthors· array · requis
A profile link (x.com/name, linkedin.com/in/name, reddit.com/user/name), post link, handle (@name, u/name), Bluesky DID or display name. Links are stored as the author's profile. A bare name or handle covers every platform.
Exemple d'appel{"name": "mute_authors", "arguments": {"id": "texte", "authors": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - search_mentions≈ 4998 tokens
Searches the workspace's mentions. You can filter by keyword, platform, status (open, ignored, done), relevant, minimum relevance, minimum confidence (0 to 1), sentiment, intent, text (q, in the post or the author's name) and time range (ISO 8601). You can also filter by one person (personId from list_people), assignee (assigneeId), author followers (minFollowers, maxFollowers), engagement counts from the platform (minLikes, minReposts, minReplies, minQuotes, minViews, minBookmarks, where posts without that count are left out), review stars (ratings, or notRatings to exclude some), author tags (tags, any of them), linked hosts (linkHosts, a host or its subdomains), replies or not (isReply), and machine-made posts (automated true or false). alertId applies an alert's whole filter, giving the mentions it would send. viewId applies a saved view from list_views on top of the rest. keywordKinds filters by the kind of keyword that matched (brand, competitor, topic), and groupIds or notGroupIds by the keyword's group (ids from list_groups). All filters are joined by AND. For OR, anyOf takes up to 10 groups of the same conditions, each an object whose conditions are joined by AND, and keeps a mention when one group matches as well as the rest. For example anyOf=[{platforms:["github"],intents:["bug_report"]},{sentiments:["negative"]}]. Snoozed mentions are hidden unless snoozed=true. sort is "newest" (the default) or "priority", an attention score built from relevance, author reach, intent and age that covers only the past 30 days of matches and comes on each mention as `priority`. Returns 10 mentions by default, up to 100 with limit. Each mention contains post, author, classification and triage.
Paramètres, retour & exemple (51)
Paramètresq· string · optionnel
Searches post text and author names.kind· string · optionnel · post | comment | repository
Only posts (post) or only comments (comment: replies, comments and answers). repository (GitHub repository events) is accepted and matches nothing, since Rumoro does not collect them. Omitted: all.sort· string · optionnel · newest | priority
newest orders by match time, latest first. priority orders by attention score, highest first, and only covers the past 30 days of matches. Older ones are still available with newest. A cursor only works with the sort it came from.tags· array · optionnel
Keeps authors your workspace gave one of these tags, matched exactly and by case. Repeat the parameter or separate values with commas.anyOf· array · optionnel
Up to 10 OR'd groups (at least 1). A mention must meet every condition of some group, plus all other conditions, so the filter reads (other conditions) AND (group 1 OR group 2 ...). Groups take view filter fields (platforms, sentiments, intents, keywordKinds, the not lists and so on) but no nested anyOf.limit· integer · optionnel
How many mentions to return, from 1 to 100. The default is 10, so narrow the filters before you ask for more.since· integer · optionnel
Keeps posts published at this time or later, as ISO 8601 or epoch ms.until· integer · optionnel
Keeps posts published at this time or earlier, as ISO 8601 or epoch ms.intent· string · optionnel
Returns only mentions with this tag. One of bug_report, buy_intent, churn_intent, comparison, complaint, event, feedback, hiring, industry_insight, launch, praise, pricing, promotional, question and testimonial.status· string · optionnel · open | ignored | done
Keeps mentions with this status only. Leave it out for all statuses.viewId· string · optionnel
Adds a saved view's filter (an id from GET /v1/views) to the other filters, with every condition joined by AND. You get exactly what the view shows. An unknown id returns 404.alertId· string · optionnel
Adds an alert rule's filter (an id from GET /v1/alerts) to the other filters. You get the mentions the rule would send, useful for a preview or an export in feed form. An unknown id returns 404.intents· array · optionnel
Keeps mentions tagged with one of these intents or topics.isReply· boolean · optionnel
true keeps replies and comments, meaning posts that answer another post. false keeps posts that are not replies. Leave it out for both.notTags· array · optionnel
Leaves out authors your workspace gave one of these tags.ratings· array · optionnel
Keeps reviews with one of these star ratings, from 1 to 5. Use ratings=1,2 for the unhappy ones. Posts that are not reviews are left out.snoozed· boolean · optionnel
true shows only snoozed mentions, which are otherwise hidden until they wake.groupIds· array · optionnel
Keeps matches of keywords in these groups only (grp_...). Repeat the parameter or separate values with commas.minLikes· integer · optionnel
Keeps posts with this many likes (upvotes, reactions) or more, counted when the post was collected. Posts without a like count are left out.minViews· integer · optionnel
Keeps posts with this many views (plays) or more, counted when the post was collected. Posts without a view count are left out.personId· string · optionnel
Keeps mentions by this person (an id from /v1/people), including merged accounts. Turns on includeMuted.platform· string · optionnel · bluesky | hackernews | github | stackoverflow | devto | reddit | x | youtube
Only this platform's posts.relevant· boolean · optionnel
true keeps mentions the classifier scored relevant. false keeps the others, including unscored ones.automated· boolean · optionnel
true keeps mentions that look machine-made, such as bot accounts, scheduled or template posts and AI-written text. false keeps the others, including mentions scored before this flag existed. Leave it out for all.keywordId· string · optionnel
Only this keyword's matches.languages· array · optionnel
Sends only posts in these languages, as ISO 639-1 codes such as en, es or de. Posts with an unknown language are left out.linkHosts· array · optionnel
Keeps posts that link to one of these hosts or its subdomains, so slack.com also matches api.slack.com. Repeat the parameter or separate values with commas.minQuotes· integer · optionnel
Keeps posts with this many quotes or more, counted when the post was collected. Posts without a quote count are left out.platforms· array · optionnel
Keeps posts from these platforms only.sentiment· string · optionnel · positive | neutral | negative
Keeps mentions with this sentiment only.assigneeId· string · optionnel
Member user id. Returns only mentions assigned to them.keywordIds· array · optionnel
Keeps matches of these keywords only.minReplies· integer · optionnel
Keeps posts with this many replies (comments) or more, counted when the post was collected. Posts without a reply count are left out.minReposts· integer · optionnel
Keeps posts with this many reposts (shares, retweets) or more, counted when the post was collected. Posts without a repost count are left out.notIntents· array · optionnel
Intent or topic tags to exclude.notRatings· array · optionnel
Star ratings (1 to 5) to hide, such as notRatings=5. Other posts are unaffected.sentiments· array · optionnel
Keeps mentions with these sentiments only.notGroupIds· array · optionnel
Hides matches from keywords that belong to these groups.includeMuted· boolean · optionnel
true also returns mentions by muted people, which are hidden by default.keywordKinds· array · optionnel
Keeps matches of keywords of these kinds only (brand, competitor, topic). Repeat the parameter or separate values with commas.maxFollowers· integer · optionnel
Keeps posts by authors with this many followers or fewer. Unknown counts are left out.minBookmarks· integer · optionnel
Keeps posts with this many bookmarks (saves) or more, counted when the post was collected. Posts without a bookmark count are left out.minFollowers· integer · optionnel
Sends only posts by authors with this many followers or more. Unknown counts are left out.minRelevance· integer · optionnel
Keeps mentions with this relevance score or higher. Unscored mentions are left out.notLanguages· array · optionnel
Leaves out posts in these languages. Posts with an unknown language are kept.notLinkHosts· array · optionnel
Leaves out posts that link to these hosts or their subdomains.notPlatforms· array · optionnel
Platforms to exclude.minConfidence· number · optionnel
Minimum classifier confidence, 0 to 1. Mentions with no confidence are dropped.notKeywordIds· array · optionnel
Keyword ids to exclude.notSentiments· array · optionnel
Leaves out these sentiments. Mentions not scored yet are kept.excludeAuthors· array · optionnel
Leaves out these authors, given as display names, handles or profile links. Repeat the parameter or send one value with commas.
Exemple d'appel{"name": "search_mentions", "arguments": {"q": "texte", "kind": "post", "sort": "newest", "tags": [], "anyOf": [], "limit": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - split_person≈ 127 tokens
Reverses a merge, so the account is a separate person again in your workspace.
Paramètres, retour & exemple (1)
Paramètresid· string · requis
The aut_... id from list_people, or author.id on a mention
Exemple d'appel{"name": "split_person", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - unmute_authors≈ 259 tokens
Takes authors off an alert's muted list and keeps the rest of the filter. Each entry can be the stored value or a link to the person's profile or posts. Authors not on the list are skipped.
Paramètres, retour & exemple (2)
Paramètresid· string · requis
The alert's idauthors· array · requis
A profile link (x.com/name, linkedin.com/in/name, reddit.com/user/name), post link, handle (@name, u/name), Bluesky DID or display name. Links are stored as the author's profile. A bare name or handle covers every platform.
Exemple d'appel{"name": "unmute_authors", "arguments": {"id": "texte", "authors": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_alert≈ 3493 tokens
Changes an alert's name, enabled, mode, schedule, filter or channelIds. filter and channelIds are replaced in full.
Paramètres, retour & exemple (8)
Paramètresid· string · requis
The alert's idmode· string · optionnel · instant | hourly | daily | weeklyname· string · optionnelevent· ? · optionnelfilter· object · optionnel
Sets the full new filter.enabled· boolean · optionnelschedule· ? · optionnel
For daily and weekly alerts. An hourly alert ignores it, but refuses a weekday.channelIds· array · optionnel
Sets the full new list.
Exemple d'appel{"name": "update_alert", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_company≈ 481 tokens
Changes the company profile (name, description, useCases, accounts) or sets the classifier context yourself. Profile changes rebuild the context, and a context you set applies until the next profile change. The context affects relevance scores more than anything else, so keep it accurate and specific. It does not apply to keywords in a group with its own description, which you change with update_group. Fields you leave out stay as they are.
Paramètres, retour & exemple (8)
Paramètresname· string · optionnelcontext· string · optionnel
Replaces the built context until the next profile change.website· ? · optionnel
The company's website. Null removes it.accounts· object · optionneluseCases· array · optionnel
Sets the full new list.guidelines· ? · optionnel
Rules for the classifier in your own words. Null removes them.competitors· array · optionnel
Sets the full new list. An empty list clears it.description· string · optionnel
Exemple d'appel{"name": "update_company", "arguments": {"name": "texte", "context": "texte", "website": "texte", "accounts": {}, "useCases": [], "guidelines": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_filters≈ 467 tokens
Changes the workspace filters. These are excludedTerms (`*` at either end is a wildcard), excludedAuthors (links, handles or names), excludedRepos (owner/name or a github.com link), subreddits.only (allowed subreddits, and when set, excluded is ignored) and subreddits.excluded. Every list is optional. A list you leave out stays as it is, and an empty list clears it. New mentions follow the change within a minute.
Paramètres, retour & exemple (4)
Paramètressubreddits· object · optionnel
Applies to Reddit only. A list you leave out stays as it is.excludedRepos· array · optionnel
Sets a new list. An empty list clears it.excludedTerms· array · optionnel
Sets a new list. An empty list clears it.excludedAuthors· array · optionnel
Sets a new list. An empty list clears it.
Exemple d'appel{"name": "update_filters", "arguments": {"subreddits": {}, "excludedRepos": [], "excludedTerms": [], "excludedAuthors": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_group≈ 526 tokens
Changes a keyword group's name, its externalId or its company description in context. Null clears externalId. Null clears context too, so the workspace profile applies again, and new mentions use the change right away. The default group can be renamed but takes no description, because it is the workspace itself and uses the company profile (update_company).
Paramètres, retour & exemple (4)
Paramètresid· string · requis
The group's id (grp_...)name· string · optionnel
The group's name, such as a client, campaign or product. Must be unique in the workspace.context· ? · optionnel
Sets a new company description for the group. Null removes it, and the workspace profile applies again. New mentions use it right away, and older ones are not scored again. The default group cannot have one (400 default_group_context), because it is the workspace itself and uses the profile.externalId· ? · optionnel
Sets a new external id. Null removes it.
Exemple d'appel{"name": "update_group", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_keyword≈ 2413 tokens
Changes a keyword. You can rename it with term: the new term is tracked from now on, with no look-back, and the keyword keeps its id, settings and what the old term found. You can set its platforms (a list, or null for all), mute or unmute it, change its kind, or set its classifier context (null clears it). You can change its matching rules, where each field is optional and an empty list clears it, with requiredTerms and requiredMode any or all, excludedTerms with a `*` wildcard at either end, excludedAuthors and caseSensitive. You can set its monthly cap with cap: { mentions: N }, where null removes it and a cap above this month's count resumes a capped keyword right away. You can move it with groupId, which returns 409 if that group already has the term. You can set reviewSources, the full list of App Store, Google Play, Trustpilot or Google Maps pages, where an empty list disconnects them and a newly added app or country brings its last 30 days free. You can replace the RSS or Atom feeds it reads with feeds, the whole list of { url }, where an empty list disconnects them and a newly added feed brings its newest 10 matching items of the last 30 days. You can switch comments on or off with comments ({ enabled, maxPerPost }; $0.008 per comment delivered). Rules only affect new mentions. Returns the keyword after the change, with its stats.
Paramètres, retour & exemple (12)
Paramètresid· string · requis
The keyword's idcap· ? · optionnel
Sets a new monthly mention cap, or null for no cap. A cap above this month's count resumes a capped keyword right away. A cap at or below the count pauses it.kind· string · optionnel · brand | competitor | topic
New kind (brand, competitor or topic).term· string · optionnel
A new term for the keyword. It keeps its id, settings and the mentions the old term found, and the new term is tracked from now on, with no look-back. A 409 when its group already tracks the new term.feeds· array · optionnel
RSS or Atom feeds this keyword reads, at most 20, each { url }: a feed's address, or a page's (a forum, a community, a blog), whose advertised feed is used, else a usual address such as /feed or /rss. Every feed is checked when saved, and a 400 names each one that cannot be read and why. Feeds are read every hour; an item is a mention of this keyword when it holds the term (with its matching rules), and only of keywords that named the feed. A newly connected feed brings its newest 10 matching items of the last 30 days, billed like any mention. On PATCH the list replaces the old one, and [] disconnects them all (their mentions stay).muted· boolean · optionnel
Muting stops polling and matching. Existing mentions are kept.context· ? · optionnel
Up to 300 characters the classifier reads for this keyword only, in addition to the company profile or the group's description. Say what the term means for you and what to ignore, for example "Basil is our deploy tool, not the herb." Null clears it.groupId· string · optionnel
Target group (grp_...). 409 if it already has this term.comments· object · optionnel
Comments under this keyword's mentions; omitted fields stay as they are (on create: off, 20 per mention).matching· object · optionnel
Fields you leave out stay as they are. An empty list clears a field.platforms· ? · optionnel
Sets a new platform list. Null means all platforms. An empty list means none, which works when the keyword has reviewSources and only collects reviews.reviewSources· array · optionnel
Sets a new list of review pages for this keyword. An empty list disconnects them all, and their reviews are kept. A page or country you add gets the free 30-day look-back. Pages already listed are unchanged.
Exemple d'appel{"name": "update_keyword", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_mention≈ 619 tokens
The only way to change a mention. Set status to "ignored" when it is not interesting, "done" when handled, or "open" to reopen it. Assign it with assigneeId, or null to remove the assignment. Hide it from the feed until an ISO 8601 time with snoozedUntil, or null to bring it back. Add a team note with note, or null to remove it. Correct the classifier with `relevant`, where true or false sets relevance to 100 or 0 and moves the mention into or out of the relevant feed, and null removes your judgment. `sentiment` sets the label, and null brings back the classifier's. Use these corrections when the user says a mention is noise or was missed. Fields you leave out stay as they are. Delivery and billing never change.
Paramètres, retour & exemple (7)
Paramètresid· string · requis
Mention id (mm_...)note· ? · optionnel
A note for your team. Null or an empty string removes it.status· string · optionnel · open | ignored | done
ignored or done marks it handled, and open reopens it.relevant· boolean|null · optionnel
Set it to override the classifier, or null to restore the classifier's score. true means relevance 100, and a filtered mention joins the relevant feed. false means 0, and it leaves. Billing is unaffected. While the mention is still being classified this returns 409 classification_pending.sentiment· ? · optionnel
The sentiment you choose. Null removes it and brings back the classifier's.assigneeId· ? · optionnel
The user id of a workspace member, or null to remove the assignment.snoozedUntil· ? · optionnel
Hides the mention from the feed until this time, given as ISO 8601 or epoch ms. Send null to bring it back now.
Exemple d'appel{"name": "update_mention", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_person≈ 327 tokens
Changes your workspace's details on a person. You can set their full tag list, notes, mute, the outreach owner (ownerId, a member's user id, or null to remove) and stage. Muting hides their posts from the feed and all channels. Collection and billing do not change.
Paramètres, retour & exemple (6)
Paramètresid· string · requis
The person's id (aut_...)tags· array · optionnel
Sets the full new list.muted· boolean · optionnelnotes· string · optionnelstage· string · optionnel · not_contacted | contacted | replied | in_talks | customer | not_a_fit
The outreach stage your team has reached with this person.ownerId· ? · optionnel
The user id of the member responsible for this contact. Null removes it.
Exemple d'appel{"name": "update_person", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_segment≈ 1104 tokens
Changes a saved segment's name, description or filter. `filter` sets the full new filter.
Paramètres, retour & exemple (4)
Paramètresid· string · requis
The segment's id (seg_...)name· string · optionnelfilter· object · optionnel
Sets the full new filter.description· string · optionnel
Exemple d'appel{"name": "update_segment", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_view≈ 3801 tokens
Changes a saved view's name, description or filter. `filter` sets the full new filter.
Paramètres, retour & exemple (4)
Paramètresid· string · requis
The view's id (vw_...)name· string · optionnelfilter· object · optionnel
Sets the full new filter.description· string · optionnel
Exemple d'appel{"name": "update_view", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - whoami≈ 134 tokens
Returns the workspace this credential works in, the kind of credential (an API key or an OAuth sign-in), whether it can write, and the signed-in user if there is one. Call it once when a session starts, to name the workspace and learn whether write tools will work.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "whoami", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».