{"skill":{"slug":"x-search","displayName":"X Search","summary":"Search X (Twitter) posts using the xAI API. Use when the user wants to find tweets, search X/Twitter, look up what people are saying on X, or find social med...","description":"---\nname: x-search\ndescription: Search X (Twitter) posts using the xAI API. Use when the user wants to find tweets, search X/Twitter, look up what people are saying on X, or find social media posts about a topic.\nhomepage: https://docs.x.ai/developers/tools/x-search\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"𝕏\",\n        \"requires\": { \"bins\": [\"python3\"], \"env\": [\"XAI_API_KEY\"] },\n        \"primaryEnv\": \"XAI_API_KEY\",\n        \"install\":\n          [\n            {\n              \"id\": \"python-brew\",\n              \"kind\": \"brew\",\n              \"formula\": \"python\",\n              \"bins\": [\"python3\"],\n              \"label\": \"Install Python (brew)\",\n            },\n          ],\n      },\n  }\n---\n\n# X Search\n\nSearch X (Twitter) posts using the xAI Grok API with real-time access to X content.\n\n## Setup\n\n1. Get your API key: https://console.x.ai\n2. Set environment variable:\n   ```bash\n   export XAI_API_KEY=\"xai-your-key-here\"\n   ```\n3. Or set `skills.\"x-search\".apiKey` / `skills.\"x-search\".env.XAI_API_KEY` in `~/.openclaw/openclaw.json`\n\n## Usage\n\n```bash\npython3 {baseDir}/scripts/search.py \"what is trending in AI right now\"\n```\n\nUseful flags:\n\n```bash\n# Filter by handles (max 10)\npython3 {baseDir}/scripts/search.py --handles jaaneek,OpenClaw \"latest posts\"\n\n# Exclude handles (max 10)\npython3 {baseDir}/scripts/search.py --exclude spambot,crypto_shill \"trending AI\"\n\n# Date range (YYYY-MM-DD)\npython3 {baseDir}/scripts/search.py --from 2026-03-01 --to 2026-03-20 \"xAI grok updates\"\n\n# Enable image/video understanding in posts\npython3 {baseDir}/scripts/search.py --images --video \"product demos\"\n```\n\n## Notes\n\n- Uses the xAI Responses API with `x_search` tool (Grok performs the search and summarizes results)\n- Cannot use `--handles` and `--exclude` at the same time\n- Results include citations with links to original X posts\n- Present results in a readable format with post content, authors, and citations\n","tags":{"latest":"1.0.0"},"stats":{"comments":1,"downloads":14482,"installsAllTime":47,"installsCurrent":47,"stars":138,"versions":1},"createdAt":1773970789565,"updatedAt":1778492046141},"latestVersion":{"version":"1.0.0","createdAt":1773970789565,"changelog":"- Created X Search skill that calls Grok to perform keyword search, semantic search, user search, and thread fetch on X","license":"MIT-0"},"metadata":{"setup":[{"key":"XAI_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"jaaneek","userId":"s176gnbpcpysb7v5ywgbebcf2s83wckk","displayName":"Jaaneek","image":"https://avatars.githubusercontent.com/u/25470423?v=4"},"moderation":null}