Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Expanded documentation with detailed response schemas for tweets and users. - Added explicit field descriptions for all tweet-returning endpoints. - Clarified available endpoints, their options, and typical response shapes. - Included example error messages for common authentication and billing issues. - Provided links to official API reference and developer console.
What This Skill Does
Provides real-time search and data retrieval for X (Twitter) through the Desearch API. Covers keyword and hashtag search, user timelines, replies, retweeters, and individual post lookup. Supports filters for date range, language, engagement counts, and media type.
Desearch provides real-time X data without requiring Twitter API access or developer account approval.
When to use it
- Monitor mentions of a product or brand as they appear
- Pull a competitor's recent posts filtered by engagement threshold
- Track a hashtag during a live event
- Fetch all replies to a specific post for sentiment analysis
- Get a user's reply history filtered by keyword
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: find recent English posts about 'Bittensor TAO' with at least 50 likes, sorted by latest
- 1Call the x endpoint with query 'Bittensor TAO', --sort Latest, --lang en, --min-likes 50
- 2Receive a Tweet[] array with post text, timestamps, and engagement counts
- 3Extract id, text, created_at, like_count, and url fields from each result
- 4Return a formatted list of matching posts with direct X links
A list of recent posts matching the query, each with text, like count, and URL
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.