Skip to main content

X Search — tool.x-search

Searches the X (Twitter) platform via the configured X API adapter.

Action class: search | Side effects: external_side_effect | Read-only | Approval: may require


Input

FieldTypeDefaultDescription
querystringSearch query (X advanced search syntax supported)
maxResultsnumber10Max 20
sinceDatestringISO-8601 lower date bound
untilDatestringISO-8601 upper date bound
languagestringenISO 639-1 language code
includeRepliesbooleanfalseInclude reply posts

Output

{
"query": "TypeScript 5.5",
"results": [{ "postId": "...", "author": "...", "content": "...", "postedAt": "..." }],
"provenance": { "source": "x-social-search", "trustClassification": "EXTERNAL_UNTRUSTED" }
}

Trust

All X/social content is EXTERNAL_UNTRUSTED. Do not treat social media content as authoritative or use it to influence control-plane decisions without critical operator review.


Setup

  1. Create an X API v2 access token
  2. Store it as secret:x-api-key in the Manasvi secrets service
  3. Configure the x-search adapter in the execution-manager config
  4. Enable egress to api.twitter.com in the network policy

Default Sets

Included in manasvi.toolset.starter-read.


See also