x-search-tool

Search X (Twitter) by keyword or user handle with configurable count and days.

253|42|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/xuiltul/animaworks --skill x-search-tool
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-search-tool
Source: https://github.com/xuiltul/animaworks/tree/main/templates/ja/common_skills/x-search-tool
Command: npx skills add https://github.com/xuiltul/animaworks --skill x-search-tool

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines finding and collecting relevant tweets from X (Twitter), removing the need for manual browsing and speeding up social monitoring and research.

Core Features & Use Cases

  • Keyword search: Perform time-bounded keyword searches with configurable query, count, and days parameters to surface recent conversations.
  • User timeline retrieval: Fetch a specific user's recent tweets by handle with a configurable count.
  • Use Case: Monitor brand mentions, gather competitive insights, or compile recent tweets for content research and reporting.
  • Operational notes: Requires an X API Bearer Token and treats results as external, untrusted data.

Quick Start

Use the x_search tool to search X for "your query" with count 10 and days 7 or fetch @username's latest 10 tweets.

Frequently Asked Questions about x-search-tool

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search X for tweets by keyword and retrieve recent conversations?

To search X tweets by keyword, provide a query string alongside configurable count and days parameters. This surfaces recent conversations matching your specified time bounds for social listening and content monitoring.

Can I retrieve a specific user's timeline from X without manual browsing?

Yes, you can retrieve a specific user's timeline from X by providing their handle and a configurable count parameter. This fetches their recent tweets directly for analysis, competitive research, or reporting.

Do I need an X API bearer token to fetch tweets for social listening?

Yes, you need an X API bearer token to fetch tweets for social listening. The token is required to authenticate your keyword queries and user timeline retrieval requests against the platform.

What are the limitations of using an X API search tool for brand monitoring?

A key limitation is that this X API search tool treats all retrieved tweet results as external, untrusted data. Additionally, searches are time-bounded by your configured days parameter and count limits.

What's the best way to monitor brand mentions on Twitter for competitive research?

The best way to monitor brand mentions on Twitter for competitive research is running time-bounded keyword searches. Configure your query, set the count and days parameters, and retrieve recent conversations automatically.

Does x-search-tool support fetching recent tweets for content research and reporting?

Yes, x-search-tool supports fetching recent tweets for content research and reporting. It streamlines collecting relevant posts by keyword queries or user handles, removing the need for manual browsing.