x-search-tool

$npx mdskill add xuiltul/animaworks/x-search-tool

Search X (Twitter) for specific topics or retrieve recent posts from any given user account.

  • Find information on current trends or monitor activity from specific accounts.
  • Integrates with the X (Twitter) platform via a configured Bearer Token.
  • Executes searches based on provided keywords, usernames, and timeframes.
  • Returns a list of tweets directly through the command-line interface.
SKILL.md
.github/skills/x-search-toolView on GitHub ↗
---
name: x-search-tool
description: >-
  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.
tags: [search, x, twitter, external]
---

# 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
More from xuiltul/animaworks