skills.rest
zeenie-ai
zeenie-aiCOMMUNITY
Explore all skills by this author →
Website𝕏@zeenie_aiGitHub

twitter-search-skill

Search recent X tweets by keywords, hashtags, mentions, and operators.

356|66|Updated Oct 13, 2025
Search Tags:#twitter#tweet search#social listening#x api#engagement metrics#query operators#media enrichment
One-click install
npx skills add https://github.com/zeenie-ai/MachinaOS --skill twitter-search-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: twitter-search-skill
Source: https://github.com/zeenie-ai/MachinaOS/tree/main/server/skills/social_agent/twitter-search-skill
Command: npx skills add https://github.com/zeenie-ai/MachinaOS --skill twitter-search-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly find relevant recent tweets on X without manually constructing complex search queries and post-processing incomplete tweet data.

Core Features & Use Cases

  • Advanced tweet searching: Supports keywords, quoted phrases, hashtags, mentions, and key X operators like from:, url:, and context: to target specific topics or accounts.
  • Rich, display-ready results: Returns expanded URLs (via display_text), author details, media attachments, engagement metrics, and referenced/quoted tweet context.
  • Query validation for reliable outcomes: Enforces X API v2 constraints (e.g., operator-only queries fail) so you get results instead of errors.

Use Case Example: Monitor mentions of a product or topic like #MachineLearning, filter out retweets, and collect engaging posts with media for curation or analysis.

Quick Start

Use the twitter-search-skill to search recent tweets for the query "#MachineLearning -is:retweet lang:en" and return 50 results.

Frequently Asked Questions about twitter-search-skill

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

FAQPage Schema
How do I search recent tweets on X using advanced query operators?▼

Search recent tweets on X by providing a query containing at least one standalone term and using supported operators like from:, url:, context:, hashtags, or mentions to filter results for specific topics or accounts.

What engagement metrics and media details are included in X API tweet search results?▼

Tweet search results return enriched payloads containing author details, public engagement metrics, media attachments, expanded URLs via display_text, and referenced or quoted tweet context for display-ready analysis.

Can I filter out retweets when monitoring brand mentions on X?▼

Yes, you can filter out retweets when monitoring brand mentions by appending the -is:retweet operator to your search query to collect only original posts.

What is the maximum number of tweets I can retrieve in a single X API search?▼

The maximum number of tweets you can retrieve in a single search is 100, as the skill honors max_results constraints between 10 and 100 for recent tweet queries.

Why does my X tweet search fail when using only operator-only queries?▼

Operator-only queries fail because X API v2 validation requires at least one standalone search term in the query to return valid results instead of an error.

Related Skills

Explore More Marketing & Sales Skills→
winsorllcwinsorllc

xurl

Post tweets, replies, quotes, and direct messages via the X API v2 CLI.

Community
Intermediate
hathbangerhathbanger

x-algorithm

Analyze and optimize X posts with CLI commands for engagement scoring.

Community
Basic
anysiteioanysiteio
19

anysite-competitor-analyzer

Aggregate competitor intelligence from LinkedIn, GitHub, and community sources.

Official
Advanced
SharpAISharpAI
3.0k

webhook-trigger

Forward Aegis events to webhook URLs with custom headers and filtering.

Official
Intermediate