x-researchGeneral-purpose X/Twitter research agent. Searches X for real-time perspectives, dev discussions, product feedback, cultural takes, breaking news, and expert...
Install via ClawdBot CLI:
clawdbot install aviclaw/x-researchGeneral-purpose agentic research over X/Twitter. Decompose any research question into targeted searches, iteratively refine, follow threads, deep-dive linked content, and synthesize into a sourced briefing.
For X API details (endpoints, operators, response format): read references/x-api.md.
All commands run from this skill directory:
cd ~/clawd/skills/x-research
source ~/.config/env/global.envbun run x-search.ts search "<query>" [options]Options:
--sort likes|impressions|retweets|recent — sort order (default: likes)--since 1h|3h|12h|1d|7d — time filter (default: last 7 days). Also accepts minutes (30m) or ISO timestamps.--min-likes N — filter by minimum likes--min-impressions N — filter by minimum impressions--pages N — pages to fetch, 1-5 (default: 1, 100 tweets/page)--limit N — max results to display (default: 15)--quick — quick mode: 1 page, max 10 results, auto noise filter (-is:retweet -is:reply), 1hr cache, cost summary--from — shorthand for from:username in query--quality — filter low-engagement tweets (≥10 likes, post-hoc)--no-replies — exclude replies--save — save results to ~/clawd/drafts/x-research-{slug}-{date}.md--json — raw JSON output--markdown — markdown output for research docsAuto-adds -is:retweet unless query already includes it. All searches display estimated API cost.
Examples:
bun run x-search.ts search "BNKR" --sort likes --limit 10
bun run x-search.ts search "from:frankdegods" --sort recent
bun run x-search.ts search "(opus 4.6 OR claude) trading" --pages 2 --save
bun run x-search.ts search "$BNKR (revenue OR fees)" --min-likes 5
bun run x-search.ts search "BNKR" --quick
bun run x-search.ts search "BNKR" --from voidcider --quick
bun run x-search.ts search "AI agents" --quality --quickbun run x-search.ts profile <username> [--count N] [--replies] [--json]Fetches recent tweets from a specific user (excludes replies by default).
bun run x-search.ts thread <tweet_id> [--pages N]Fetches full conversation thread by root tweet ID.
bun run x-search.ts tweet <tweet_id> [--json]bun run x-search.ts watchlist # Show all
bun run x-search.ts watchlist add <user> [note] # Add account
bun run x-search.ts watchlist remove <user> # Remove account
bun run x-search.ts watchlist check # Check recent from allWatchlist stored in data/watchlist.json. Use for heartbeat integration — check if key accounts posted anything important.
bun run x-search.ts cache clear # Clear all cached results15-minute TTL. Avoids re-fetching identical queries.
When doing deep research (not just a quick search), follow this loop:
Turn the research question into 3-5 keyword queries using X search operators:
from: specific known experts(broken OR bug OR issue OR migration)(shipped OR love OR fast OR benchmark)url:github.com or url: specific domains-is:retweet (auto-added), add -is:reply if needed-airdrop -giveaway -whitelist if crypto topics floodingRun each query via CLI. After each, assess:
from: specifically?thread command?web_fetch?When a tweet has high engagement or is a thread starter:
bun run x-search.ts thread <tweet_id>When tweets link to GitHub repos, blog posts, or docs, fetch with web_fetch. Prioritize links that:
Group findings by theme, not by query:
### [Theme/Finding Title]
[1-2 sentence summary]
- @username: "[key quote]" (NL, NI) [Tweet](url)
- @username2: "[another perspective]" (NL, NI) [Tweet](url)
Resources shared:
- [Resource title](url) — [what it is]Use --save flag or save manually to ~/clawd/drafts/x-research-{topic-slug}-{YYYY-MM-DD}.md.
-is:reply, use --sort likes, narrow keywordsOR, remove restrictive operators-$ -airdrop -giveaway -whitelistfrom: or --min-likes 50has:linksOn heartbeat, can run watchlist check to see if key accounts posted anything notable. Flag to Frank only if genuinely interesting/actionable — don't report routine tweets.
skills/x-research/
├── SKILL.md (this file)
├── x-search.ts (CLI entry point)
├── lib/
│ ├── api.ts (X API wrapper: search, thread, profile, tweet)
│ ├── cache.ts (file-based cache, 15min TTL)
│ └── format.ts (Telegram + markdown formatters)
├── data/
│ ├── watchlist.json (accounts to monitor)
│ └── cache/ (auto-managed)
└── references/
└── x-api.md (X API endpoint reference)Generated Mar 1, 2026
A tech startup launching a new API can use this skill to monitor real-time developer reactions on X. By searching for mentions of their product name and related keywords, they can identify pain points, positive feedback, and expert opinions to adjust their launch strategy and documentation.
A cryptocurrency trader can research specific tokens like $BNKR by filtering out spam with operators like -airdrop. They can track expert opinions, community sentiment, and breaking news to inform trading decisions, using the watchlist feature to monitor key influencers.
A software engineer considering migrating to a new library version (e.g., Opus 4.6) can search X for discussions on bugs, performance benchmarks, and migration experiences. The thread command helps dive into detailed technical conversations, while linked GitHub resources provide code examples.
A media company covering industry events or cultural trends can use this skill to gather real-time perspectives and breaking news from X. By setting up watchlists for key accounts and using quick searches, they can synthesize public discourse into timely briefings for content creation.
A product manager can research user feedback on a recent feature release by searching X for mentions of their product. Using quality filters and sorting by likes, they can identify common issues and positive signals to prioritize improvements and communicate with stakeholders.
Offer curated X research reports to clients in tech, finance, or media industries. Use the skill's synthesis capabilities to provide actionable insights on market trends, competitor analysis, or public sentiment, delivered as markdown briefings with sourced tweets.
Integrate this skill into a digital marketing agency's workflow to monitor brand mentions, campaign performance, and influencer engagement on X. The watchlist and quick search features enable real-time reporting and strategy adjustments for clients.
Package the CLI tool as a premium API service or desktop application for developers and researchers. Offer advanced features like extended historical searches beyond 7 days, automated report generation, and team collaboration tools.
💬 Integration Tip
Integrate with existing project management tools by saving research outputs to shared drafts, and use the watchlist for automated monitoring of key accounts during team standups or weekly reviews.
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
Search indexed Discord community discussions via Answer Overflow. Find solutions to coding problems, library issues, and community Q&A that only exist in Discord conversations.
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.