Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Search X (Twitter) in real time. Find posts by keyword, user, or hashtag. Get a user's timeline, replies, retweeters, or fetch specific posts by ID or URL. S...
Search X (Twitter) in real time. Find posts by keyword, user, or hashtag. Get a user's timeline, replies, retweeters, or fetch specific posts by ID or URL. S...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Real-time X/Twitter search and monitoring. Search posts, track users, get timelines, replies, and retweeters with powerful filtering.
Get an API key from https://console.desearch.ai Set environment variable: export DESEARCH_API_KEY='your-key-here'
All tweet-returning endpoints share these shapes. Fields marked * are always present.
FieldTypeDescriptionid*stringPost IDtext*stringPost contentcreated_at*stringISO 8601 timestampurlstring|nullDirect link: https://x.com/{username}/status/{id}like_count*intLikesretweet_count*intRetweetsreply_count*intRepliesquote_count*intQuotesbookmark_count*intBookmarksview_countint|nullViewslangstring|nullLanguage code (e.g. en)is_retweetbool|nullIs a retweetis_quote_tweetbool|nullIs a quote tweetconversation_idstring|nullThread IDin_reply_to_screen_namestring|nullUsername of post being replied toin_reply_to_status_idstring|nullID of post being replied tomediaarray|null[{media_url, type}] โ type: photo, video, animated_gifentitiesobject|null{hashtags, symbols, urls, user_mentions}quoteTweet|nullNested quoted tweetretweetTweet|nullOriginal tweet (timeline endpoint only)userUser|nullPost author โ see User below
FieldTypeDescriptionid*stringUser IDusername*string@handle (without @)namestring|nullDisplay nameurlstring|nullProfile URLdescriptionstring|nullBiofollowers_countint|nullFollowersfollowings_countint|nullFollowingstatuses_countint|nullTotal tweets postedverifiedbool|nullLegacy verified badgeis_blue_verifiedbool|nullTwitter Blue subscriberlocationstring|nullSelf-reported locationcreated_atstring|nullAccount creation dateprofile_image_urlstring|nullAvatar URL
Search X posts by keyword, hashtag, or user with engagement filters. scripts/desearch.py x "Bittensor TAO" --sort Latest --count 10 scripts/desearch.py x "AI news" --user elonmusk --start-date 2025-01-01 scripts/desearch.py x "crypto" --min-likes 100 --verified --lang en Options: OptionDescription--sortTop (default) or Latest--user, -uFilter to posts by username--start-dateStart date UTC (YYYY-MM-DD)--end-dateEnd date UTC (YYYY-MM-DD)--langLanguage code (e.g. en, es)--verifiedOnly verified users--blue-verifiedOnly Twitter Blue users--is-quoteOnly quote tweets--is-videoOnly posts with video--is-imageOnly posts with images--min-retweetsMinimum retweet count--min-repliesMinimum reply count--min-likesMinimum like count--count, -nResults count (default: 20, max: 100) Response: Tweet[]
Fetch a single post by its numeric ID. scripts/desearch.py x_post 1892527552029499853 Response: Tweet
Retrieve one or more posts by their X URLs. scripts/desearch.py x_urls "https://x.com/user/status/123" "https://x.com/user/status/456" Response: Tweet[]
Search within a specific user's posts for a keyword. scripts/desearch.py x_user elonmusk --query "AI" --count 10 Options: OptionDescription--query, -qKeyword to filter the user's posts--count, -nResults count (default: 10, max: 100) Response: Tweet[]
Fetch the most recent posts from a user's timeline. Retweets include a retweet field with the original post. scripts/desearch.py x_timeline elonmusk --count 20 Options: OptionDescription--count, -nNumber of posts (default: 20, max: 100) Response: { user: User, tweets: Tweet[] }
List users who retweeted a specific post. Supports cursor-based pagination. scripts/desearch.py x_retweeters 1982770537081532854 scripts/desearch.py x_retweeters 1982770537081532854 --cursor "AAAAANextCursorValue==" Options: OptionDescription--cursorPagination cursor from a previous response Response: { users: User[], next_cursor: string|null } โ next_cursor is null when no more pages remain.
Fetch a user's tweets-and-replies timeline. Replies have in_reply_to_screen_name and in_reply_to_status_id set. scripts/desearch.py x_replies elonmusk --count 10 scripts/desearch.py x_replies elonmusk --query "AI" --count 10 Options: OptionDescription--count, -nResults count (default: 10, max: 100)--query, -qFilter keyword Response: Tweet[]
Fetch replies to a specific post by ID. scripts/desearch.py x_post_replies 1234567890 --count 10 scripts/desearch.py x_post_replies 1234567890 --query "thanks" --count 5 Options: OptionDescription--count, -nResults count (default: 10, max: 100)--query, -qFilter keyword within replies Response: Tweet[]
Status 401, Unauthorized (e.g., missing/invalid API key) { "detail": "Invalid or missing API key" } Status 402, Payment Required (e.g., balance depleted) { "detail": "Insufficient balance, please add funds to your account to continue using the service." }
API Reference Desearch Console
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.