x-topic-search

X Topic Search

Search X/Twitter posts by topic through the local Frevana daemon.

Purpose

This skill is for finding X/Twitter posts for a topic or query using the Chrome Extension-backed Frevana MCP tool frevana_x_search_topic.

Inputs:

topic (required) - topic, keyword, hashtag, or query to search on X
sort (optional) - top or live, defaults to Frevana's tool default
count (optional) - number of posts to fetch, max 100
fetchMode (optional) - quick or full, defaults to quick
cursor (optional) - cursor from a previous result set
includeReplies (optional) - include replies when available
includeQuotes (optional) - include quotes when available
includeMedia (optional) - include media metadata when available
maxScrollRounds (optional) - maximum scroll rounds during collection
minCount (optional) - minimum number of posts to collect before stopping
timeout (optional) - timeout in milliseconds

Output:

raw Frevana tool result text from frevana_x_search_topic

Summarize the results unless the user asks for the raw output.

What This Skill Needs

user-provided topic
bundled scripts/setup.sh wrapper, which downloads and runs the latest official Frevana setup script
Frevana local daemon running after setup, default port 12306
Chrome connected through the Frevana Chrome Extension
the user logged in to X/Twitter in Chrome
curl
bash
python3

This is a Chrome Extension skill. It uses the local daemon and Chrome Extension session.

Execution Order

Use this flow:

Confirm the user has provided topic or an equivalent X/Twitter search query.
Prefer the script over ad hoc frevana call commands.
Default fetchMode to quick when the user does not specify it. Do not invent other optional sort, count, cursor, reply, quote, media, scroll, minimum-count, or timeout fields.
Let the script run bundled scripts/setup.sh before every Frevana tool call.
If setup reports Chrome disconnected, stop and tell the user to open Chrome, connect the Frevana extension, and retry.
Run the X topic search with the provided options only after setup succeeds.
If the result looks like login/auth content or the call fails because X is unavailable, tell the user they must be logged in to X/Twitter in Chrome.
Return a concise summary of the posts, or the raw output if requested.
When useful, save the output to a file.

Commands

Basic topic search

bash <skill-path>/scripts/search_x_topics.sh \
  --topic "vibe coding"

--query and --q are accepted as aliases for --topic.

Live search with a smaller result count

bash <skill-path>/scripts/search_x_topics.sh \
  --topic "vibe coding" \
  --sort live \
  --count 10 \
  --fetch-mode quick \
  --timeout 60000

Include optional metadata

bash <skill-path>/scripts/search_x_topics.sh \
  --topic "#buildinpublic" \
  --include-replies \
  --include-quotes \
  --include-media

Continue from a cursor

bash <skill-path>/scripts/search_x_topics.sh \
  --topic "vibe coding" \
  --cursor "cursor-from-previous-result"

Save output to file

bash <skill-path>/scripts/search_x_topics.sh \
  --topic "vibe coding" \
  --output ./out/x-topic-search-result.txt

Fixed Tool Call Shape

The script calls:

frevana call frevana_x_search_topic '<json_args>'

The JSON arguments use this shape, omitting optional fields that were not provided:

{
  "topic": "vibe coding",
  "sort": "live",
  "count": 10,
  "fetchMode": "quick",
  "cursor": "cursor-from-previous-result",
  "includeReplies": true,
  "includeQuotes": true,
  "includeMedia": true,
  "maxScrollRounds": 5,
  "minCount": 10,
  "timeout": 60000
}

Do not pass unsupported fields to frevana_x_search_topic. Always send fetchMode; default it to quick when the user does not specify a value.

Output

Success: the script prints the Frevana tool result to stdout
With --output: the same result is also written to the specified file path
Failure: the script prints the Frevana error or preflight failure to stderr and exits non-zero

Notes

Require --topic, --query, or --q.
Use --sort live only when the user asks for latest/recent/live X posts. Otherwise omit it or use top only if requested.
--count must be an integer from 1 through 100.
--fetch-mode must be quick or full; it defaults to quick.
Boolean metadata options are sent only when the matching flag is present.
Use a higher --timeout for busy topics or slow X sessions.
If curl is missing, stop and tell the user to install curl.
If python3 is missing, stop and tell the user to install python3.
The script runs bundled scripts/setup.sh before every search, matching the original Frevana skill flow.
scripts/setup.sh downloads and executes the latest official setup script from https://raw.githubusercontent.com/FinpeakInc/frevana-cli-releases/refs/heads/main/skills/frevana/scripts/setup.sh.
If frevana is missing, the official setup script installs the Frevana binary before starting/checking the daemon.

About this skill