SkillFoxx

x-research skill

An X (Twitter) research skill: the agent searches posts, reads threads and profiles, and assembles a briefing with source links

  • 1,247 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • Runs a Bun command and calls the paid X API
  • Reads and saves files with research results
All reasons and checks

rohunvora/x-research-skillAuthor:rohunvora

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/x-research

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Runs a Bun command and calls the paid X API
  • Reads and saves files with research results

This is third-party code. Review the repository files before installing.

What it does

The skill wraps the X API into a Bun command line tool so the agent can search posts by query, pull full threads by id, read a user's recent posts, and keep a watchlist. Search sorts by likes, impressions, retweets or recency, filters by time and minimum likes, and strips retweets and replies. A quick mode handles cheap targeted checks, and a cache avoids paying for repeat queries. During research the agent breaks a question into several queries, follows threads, opens linked content, and synthesizes findings by theme with quotes and links. Every search prints an estimated API cost.

Who it is for. For marketers, SMM specialists, product managers and developers who need a quick read on what X is saying about a topic.

Good fit when

  • You need to see what X says about a product, release or topic
  • You need to collect opinions and feedback with links to sources
  • You need to watch a set of accounts and catch notable posts

Not a fit when

  • You need to post or manage an account, the skill does not do that
  • You have no access to the paid X API and its prepaid credits

Example request

Search X for what people say about the new model release in the last day and build a briefing with links

Limitations

You need an X API bearer token and prepaid credits: the X API is pay per request, one search page costs roughly half a dollar, and exact prices are in the X console. Running the command requires Bun installed. The skill uses recent search over the last 7 days; full archive on the same plan is not yet implemented. Access to X from Russia is unstable and reaching the API may require a VPN.

How to disable. Remove the x-research folder from the agent's skills directory (.claude/skills/ or skills/) and unset the X_BEARER_TOKEN environment variable.

FAQ

Do I need paid X API access?

Yes. The X API is pay per request via prepaid credits; the skill shows an estimated cost after each search and cuts spend with caching and a quick mode.

Can the skill post?

No. It only reads: it searches posts, threads and profiles. Posting and account management are out of scope.

Discussion

No questions or reviews yet.

Skills

Skills for researching Reddit from an agent: semantic search over posts and comments, trends, subreddit discovery and lead finding via reddapi.dev

SkillExtended access15

Nine skills for Claude Code and Codex write tweets and threads in your voice, extract hooks and plan a content week.

PluginExtended access177

A skill for Claude Code and Codex on writing posts and running an X account with six creators' methods and your own data.

SkillMinimal access1.3K

A skill that audits accounts and viral posts on Xiaohongshu, Douyin, Kuaishou, WeChat Channels and Bilibili, then drafts a copy.

SkillExtended access369
Official

A set of 131 redfoxdata skills for Chinese social data and content: search, account analysis, video downloads, titles and banned-word checks

SkillExtended access462
Needs a VPN

Four Claude Code skills that take a post for X from gathering material and picking topics to a ready draft

SkillExtended access353

README in short

The README describes a skill for Claude Code and OpenClaw that turns the X API into a fast command line tool. It covers search with sorting and filters, reading profiles and threads, a watchlist and a cache. Install is by cloning the repository into the skills folder, then you set an X API bearer token and install Bun. A dedicated section breaks down request costs and ways to reduce them. The README shows both natural language use and the full list of command flags.

README badge

Original SKILL.md

---
name: x-research
description: >
  General-purpose X/Twitter research agent. Searches X for real-time perspectives,
  dev discussions, product feedback, cultural takes, breaking news, and expert opinions.
  Works like a web research agent but uses X as the source.
  Use when: (1) user says "x research", "search x for", "search twitter for",
  "what are people saying about", "what's twitter saying", "check x for", "x search",
  "/x-research", (2) user is working on something where recent X discourse would provide
  useful context (new library releases, API changes, product launches, cultural events,
  industry drama), (3) user wants to find what devs/experts/community thinks about a topic.
  NOT for: posting tweets or account management. Note: currently uses recent search (last 7 days). Full-archive search is available on the same pay-per-use X API plan but not yet implemented in this skill.
---

# X Research

General-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`.

## CLI Tool

All commands run from this skill directory:

```bash
cd ~/clawd/skills/x-research
source ~/.config/env/global.env
```

Report a problem