# X Search Tool

> X (Twitter) search tool for keyword search and fetching tweets from a specified account. Use when: searching X for topics, reading a user timeline, or tracking trends and posts.

- Skill: `xuiltul/x-search-tool` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xuiltul/x-search-tool`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xuiltul/x-search-tool/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xuiltul (https://skillmd.com/u/xuiltul)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/xuiltul/x-search-tool

---


# X Search Tool

External tool for X (Twitter) search and tweet retrieval.

## Invocation via Bash

Use **Bash** with `animaworks-tool x_search <subcommand> [args]`:

### search — Keyword search
```bash
animaworks-tool x_search "search query" [-n 10] [--days 7]
```

### user_tweets — Get user tweets
```bash
animaworks-tool x_search --user @username [-n 10]
```

## Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| query | string | — | Search query |
| user | string | — | Username (with @) |
| count | integer | 10 | Number of results |
| days | integer | 7 | Search period in days |

## CLI Usage (S/C/D/G-mode)

```bash
animaworks-tool x_search "search query" [-n 10] [--days 7]
animaworks-tool x_search --user @username [-n 10]
```

## Notes

- X API Bearer Token must be configured
- Search results are treated as external (untrusted) data