# felo-x-search

A skill for Claude Code and Codex that searches X (Twitter) data through the Felo X Search API. It triggers on queries about user profiles, tweets, trending topics, and replies.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 106 installs · ★ 251 repo stars
- Author: Felo-Inc
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Felo-Inc/felo-skills/tree/HEAD/felo-x-search/SKILL.md
- Updated: 2026-07-22
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/felo-x-search

## What it does

This skill queries X data to retrieve profiles, search tweets, track discussions, and pull replies. Output comes formatted as Markdown with engagement statistics or as raw JSON when using the `--json` option. Tweet searches support pagination cursors and time range parameters like `--since-time` and `--until-time`.

Execution runs through the `felo x` CLI command, the bundled Node script, or direct HTTP calls to Felo OpenAPI endpoints. It does not handle broad web searches or page scraping, which rely on separate companion skills.

Requests fail with `INVALID_API_KEY` unless the `FELO_API_KEY` environment variable holds a valid token created on `felo.ai`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/felo-x-search/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/felo-x-search/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/felo-x-search/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/felo-x-search/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Felo-Inc/felo-skills felo-x-search
```

2. **Manually: put the files in place**
- File: `.github/skills/felo-x-search/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Felo-Inc/felo-skills --path felo-x-search
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/felo-x-search/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Felo-Inc/felo-skills --skill felo-x-search -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Felo-Inc/felo-skills/tree/HEAD/felo-x-search/SKILL.md

## When to use it
- search X posts by keyword and time boundaries
- inspect user profile statistics and follower counts
- fetch discussion replies for a specific post ID
- retrieve recent posts published by an account

## Example prompts
- Search X for recent discussions about the latest Claude release
- Look up the X profile for @elonmusk and show recent posts
- /felo-x-search get replies for tweet ID 1234567890

## Similar
- [DuckDuckGo & Felo AI Search](https://affpapa.org/en/nevibecode/mcp/duckduckgo-felo-ai-search.md) — MCP server · 12697 installs
- [twitter-search](https://affpapa.org/en/nevibecode/skills/twitter-search.md) — skill · 136 installs
- [Twitter/X Scraper — Profiles, Tweets & Search](https://affpapa.org/en/nevibecode/mcp/twitterx-scraper-profiles-tweets-search.md) — MCP server · 5492 installs
- [x-scraper](https://affpapa.org/en/nevibecode/skills/x-scraper.md) — skill · 20800 installs
- [Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)](https://affpapa.org/en/nevibecode/mcp/social-media-search-api-twitter-instagram-reddit-tiktok-xpoz.md) — MCP server · ★ 13 repo stars
- [twitter](https://affpapa.org/en/nevibecode/skills/resciencelab-twitter.md) — skill · 2100 installs

From the same set: [felo-inc/felo-skills](https://affpapa.org/en/nevibecode/by/felo-inc/felo-skills.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
