A high-performance search skill for accessing real-time X (Twitter) data including user profiles, tweets, and conversation threads.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install felo-x-search
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install felo-x-search using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Felo X Search?
The Felo X Search skill is a professional-grade integration designed for Openclaw Skills that enables AI agents to interact directly with the X (Twitter) ecosystem. By leveraging the Felo X Search API, developers can programmatically retrieve rich metadata from social profiles, monitor trending topics, and analyze complex tweet engagement metrics.
This skill serves as a bridge between social media intelligence and AI automation. Whether you are building a sentiment analysis bot or a real-time news aggregator, Felo X Search provides the granular control needed to filter through millions of data points to find specific user information and tweet replies with high precision.
Felo X Search Use Cases
- Investigating X user profiles to extract follower counts, bios, and account history.
- Monitoring specific keywords or advanced search queries to track real-time trends.
- Retrieving historical tweets from specific influencers or corporate accounts.
- Analyzing conversation threads by pulling all replies to a specific tweet ID.
- Conducting social media market research and competitor analysis.
How Felo X Search Works
- The AI agent identifies a request related to X or Twitter data through user intent or explicit commands like /felo-x-search.
- The skill validates the presence of the FELO_API_KEY environment variable.
- The request is routed through the Felo X Search API using specific endpoints for user info, tweet search, or replies.
- Data is fetched using customizable parameters such as limits, time filters, and pagination cursors.
- The skill processes the raw API response and formats it into human-readable Markdown or structured JSON for the user.
Felo X Search Setup
1. Obtain Your API Key
Visit felo.ai, navigate to Settings > API Keys, and generate a new key.
2. Configure Environment Variables
Set your API key in your terminal environment to authenticate requests:
# Linux or macOS
export FELO_API_KEY="your-api-key-here"
# Windows PowerShell
$env:FELO_API_KEY="your-api-key-here"
3. Installation
Install the Felo AI package globally to use the CLI tool:
npm install -g felo-ai
Felo X Search Data Schema & Taxonomy
The skill returns structured data categorized by user or tweet objects. Below is the standard schema for output:
| Data Type | Key Fields Included |
|---|---|
| User Profile | User ID, Follower/Following counts, Bio, Location, Creation Date |
| Tweet Object | Tweet ID, Timestamp, Content, Like/Retweet/Reply counts |
| Search Metadata | Pagination cursors (next_cursor), total result count |
| Replies | Threaded tweet objects linked to a parent Tweet ID |
Felo X Search Advanced Features
- Support for X Advanced Search syntax within keyword queries.
- Pagination management using next_cursor for handling large datasets.
- Batch processing for user lookups by providing comma-separated usernames.
- Time-based filtering using --since-time and --until-time parameters.
- Flexible output switching between clean Markdown reports and raw JSON data for downstream processing.
SKILL.md
Loading
Related Openclaw Skills
GetNote to Notion Daily Sync
This skill automatically aggregates recordings, meeting notes, and tasks from GetNote into a structured daily report within your Notion database.
Tweet Generator
A privacy-first content creation toolkit for drafting, optimizing, and scheduling social media posts directly from your CLI.
Report Search AI Skill
A specialized tool for searching and extracting professional research reports, industry insights, and financial data from fxbaogao.com.
Viral Script Writer
An expert AI writing assistant that generates high-conversion video scripts based on the Golden 3 Seconds rule and proven viral methodologies.
UGC Hook Analyzer
A specialized AI agent tool designed to diagnose first-3-second retention issues and generate high-converting video hooks for short-form platforms.
FT AI Market Data
A unified interface for accessing comprehensive China A-share market data, including real-time quotes, IPOs, and valuation metrics.
Featured*
