desearch-x-search

What This Skill Does

The desearch-x-search skill is a comprehensive integration for OpenClaw that enables real-time interaction with the X (formerly Twitter) platform. It allows users to perform sophisticated searches using keywords, hashtags, or user handles, while applying advanced filtering parameters. Beyond basic searching, the tool provides capabilities to retrieve full user timelines, explore specific reply threads, identify individuals who have retweeted specific content, and batch-process post lookups via URLs. It acts as an abstraction layer over the Desearch API, facilitating high-frequency data gathering and monitoring directly from your terminal or AI workflow.

Installation

1. Ensure you have the OpenClaw environment installed on your machine.
2. Execute the command clawhub install openclaw/skills/skills/okradze/desearch-x-search to add the tool to your registry.
3. Navigate to https://console.desearch.ai to generate your authentication credentials.
4. Securely store your credentials in your local shell environment by running: export DESEARCH_API_KEY='your-key-here'. Verify the installation by attempting a basic search command like scripts/desearch.py x "OpenClaw" --count 1.

Use Cases

This skill is primarily used for OSINT (Open Source Intelligence), social media monitoring, and trend analysis. Researchers can track the sentiment around specific blockchain projects by filtering posts with high engagement thresholds. Marketing teams can use it to fetch a target user's timeline to understand content cadence and engagement patterns. It is also highly effective for developers building recommendation engines who need to pull live post data based on specific language or media requirements, such as finding only video-based content related to a specific technical query.

Example Prompts

1. "Use desearch to find the 10 most recent posts about 'AI agents' that have at least 500 likes and include a video."
2. "Get the latest timeline for user @OpenClawAI and identify the retweeters of their most recent major announcement."
3. "Search for all replies to the post with ID 1892527552029499853 that contain the word 'tutorial'."

Tips & Limitations

The tool is rate-limited by the underlying Desearch API; ensure you manage your --count parameters to stay within your plan's limits. When performing deep analysis, use the --sort Latest flag to ensure you aren't seeing stale content. Note that filtering by verified status is helpful for reducing noise, but may exclude high-quality content from non-verified accounts. Always handle API keys securely and avoid hardcoding them in scripts shared in public repositories.