x_twitter_api

Search X/Twitter posts by keyword and handle with normalized JSON output.

1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/antonyfmunoz/OS --skill x-twitter-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x_twitter_api
Source: https://github.com/antonyfmunoz/OS/tree/main/skills/tools/x_twitter_api
Command: npx skills add https://github.com/antonyfmunoz/OS --skill x-twitter-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The x_twitter_api skill helps you find relevant X/Twitter posts and accounts to support research, trend analysis, and outbound insights for your current business stage.

Core Features & Use Cases

  • Keyword and handle search: Run recent-window searches for posts by topic or targeted per-handle queries.
  • Bird (free) vs xAI (paid) retrieval: Uses a cookie-authenticated GraphQL browser approach first, then falls back to xAI semantic search when needed.
  • Normalized research output: Produces a consistent item schema (id, text, url, author_handle, date, engagement, relevance) for downstream skills like trend discovery and ICP signal detection.
  • Use case: Monitor competitor or market chatter, then feed the best posts into an ICP pain-signal workflow for tailored outreach.

Quick Start

Ask the AI to search X for recent posts about "AI agents startup" from 2026-03-01 to 2026-04-01 and return the top matching items with URLs and engagement metrics.

Frequently Asked Questions about x_twitter_api

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

FAQPage Schema
How do I search X for posts without paying for the official Twitter API?

You can search X for posts without official API costs by using a cookie-authenticated Bird GraphQL browsing approach as the primary free retrieval path, falling back to xAI semantic search if needed. This retrieves posts by keyword or handle within a specified date range.

What is the best way to monitor Twitter trends and find ICP signals for outreach?

Monitoring Twitter trends and finding ICP signals is done by retrieving normalized X posts with engagement and relevance fields. You can extract recent chatter or reply signals and feed them directly into downstream workflows for tailored outbound outreach.

How do I get structured JSON data from a social media keyword search?

Getting structured JSON from a social media keyword search involves retrieving items with a consistent schema containing id, text, url, author_handle, date, and engagement metrics. This normalized output supports downstream analysis like trend discovery.

Does the x_twitter_api skill support filtering posts by specific date ranges?

Yes, the x_twitter_api skill supports filtering posts by specific date ranges. You can query recent-window searches for posts by topic or targeted per-handle queries, such as asking the AI to return top matching items from a specific start date to an end date.

Can I use xAI semantic search as a fallback for retrieving X posts?

Yes, you can use xAI semantic search as a paid fallback for retrieving X posts. The mechanism attempts the free cookie-authenticated Bird GraphQL browser approach first, then automatically switches to the paid semantic search path when the primary method fails.

What are the limitations of using cookie-based GraphQL for Twitter search?

A key limitation of cookie-based GraphQL for Twitter search is its reliability as a free path, which is why it has a paid xAI semantic search fallback. It requires cookie authentication for browsing and produces normalized outputs that may need downstream processing for EOS research.