# Send X / Twitter Search to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "x-twitter-search",
    "name": "X / Twitter Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/blueberrywoodsym/x-twitter-search",
    "canonicalUrl": "https://clawhub.ai/blueberrywoodsym/x-twitter-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/x-twitter-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=x-twitter-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      ".gitignore",
      "package.json",
      "README.md",
      "SKILL.md",
      "scripts/search.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/x-twitter-search"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/x-twitter-search",
    "downloadUrl": "https://openagent3.xyz/downloads/x-twitter-search",
    "agentUrl": "https://openagent3.xyz/skills/x-twitter-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/x-twitter-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/x-twitter-search/agent.md"
  }
}
```
## Documentation

### Search X

Real-time X/Twitter search with two modes:

xAI Grok (default) — AI-powered search with x_search tool, up to 30 days
X API (--x-api) — Native X search, up to 7 days, pay-per-use

### Option 1: xAI API (default)

export XAI_API_KEY="xai-YOUR-KEY"

Get your key at: https://console.x.ai

### Option 2: X API (native)

export X_BEARER_TOKEN="YOUR-BEARER-TOKEN"

Get your token at: https://console.x.com

Note: X API uses pay-per-usage pricing. No subscription needed.

### Basic Search (xAI Grok)

node {baseDir}/scripts/search.js "AI video editing"

### Native X API Search

node {baseDir}/scripts/search.js --x-api "AI video editing"
node {baseDir}/scripts/search.js --x-api --max 50 "trending topic"  # More results

### Filter by Time

node {baseDir}/scripts/search.js --days 7 "breaking news"
node {baseDir}/scripts/search.js --days 1 "trending today"
node {baseDir}/scripts/search.js --x-api --days 7 "news"  # X API max is 7 days

### Filter by Handles

node {baseDir}/scripts/search.js --handles @elonmusk,@OpenAI "AI announcements"
node {baseDir}/scripts/search.js --exclude @bots "real discussions"

### Output Options

node {baseDir}/scripts/search.js --json "topic"        # Full JSON response
node {baseDir}/scripts/search.js --compact "topic"     # Just tweets, no fluff
node {baseDir}/scripts/search.js --links-only "topic"  # Just X links

### Example Usage in Chat

User: "Search X for what people are saying about Claude Code"
Action: Run search with query "Claude Code"

User: "Find tweets from @remotion_dev in the last week"
Action: Run search with --handles @remotion_dev --days 7

User: "What's trending about AI on Twitter today?"
Action: Run search with --days 1 "AI trending"

User: "Search X for Remotion best practices, last 30 days"
Action: Run search with --days 30 "Remotion best practices"

### xAI Grok Mode (default)

Uses xAI's Responses API (/v1/responses) with the x_search tool:

Model: grok-4-1-fast (optimized for agentic search)
Up to 30 days of history
AI-powered result formatting with citations
Returns real tweets with URLs

### X API Mode (--x-api)

Uses X's native search API (/2/tweets/search/recent):

Up to 7 days of history
Pay-per-usage pricing (no subscription)
Raw tweet data with metrics
Up to 100 results per query

### Response Format

Each result includes:

@username (display name)
Tweet content
Date/time
Engagement metrics (X API mode)
Direct link to tweet

### Environment Variables

xAI Mode:

XAI_API_KEY - Your xAI API key (required for default mode)
SEARCH_X_MODEL - Model override (default: grok-4-1-fast)
SEARCH_X_DAYS - Default days to search (default: 30)

X API Mode:

X_BEARER_TOKEN - Your X API Bearer Token
TWITTER_BEARER_TOKEN - Alternative env var name

### Security & Permissions

What this skill does:

Calls xAI's /v1/responses endpoint (Grok mode) or X's /2/tweets/search/recent endpoint (X API mode)
Returns public tweet data with URLs and citations
All requests go only to api.x.ai or api.x.com

What this skill does NOT do:

Does not post, like, retweet, or modify any X/Twitter content
Does not access your X/Twitter account or DMs
Does not read config files or access the local filesystem
Does not send credentials to any third-party endpoint
Cannot be invoked autonomously by the agent (disable-model-invocation: true)

Review scripts/search.js before first use to verify behavior.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: blueberrywoodsym
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/x-twitter-search)
- [Send to Agent page](https://openagent3.xyz/skills/x-twitter-search/agent)
- [JSON manifest](https://openagent3.xyz/skills/x-twitter-search/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/x-twitter-search/agent.md)
- [Download page](https://openagent3.xyz/downloads/x-twitter-search)