xurl

Automate X posting, searching, and messaging via the xurl CLI with structured JSON output.

Updated May 15, 2026
One-click install
npx skills add https://github.com/cabezno/bmb-encover-agent --skill xurl-cabezno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/cabezno/bmb-encover-agent/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/cabezno/bmb-encover-agent --skill xurl-cabezno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you perform common X (Twitter) actions programmatically without hand-crafting HTTP requests, while still supporting raw API calls when you need full control.

Core Features & Use Cases

  • Official X API CLI access: Use xurl to post, reply, quote, delete, and manage engagement (like/repost/bookmark) with JSON output to stdout.
  • Discovery workflows: Search posts, read timelines, and fetch user info/mentions to support research and engagement.
  • Messaging and media: Send DMs and upload images/videos (including checking media processing status).
  • v2 raw endpoint mode: Use curl-style commands to hit any X API v2 endpoint directly for advanced or niche operations.

Quick Start

First set up authentication as described in the One-Time User Setup section, then run xurl whoami to confirm access before attempting any posting or messaging.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I automate X Twitter posting and direct messaging via the command line?

Automate X Twitter posting and direct messaging by using the xurl CLI to execute high-level shortcut commands or direct v2 endpoint calls, returning structured JSON output to stdout.

Can I search posts and fetch user mentions on X using API v2?

You can search posts and fetch user mentions on X using API v2 by running xurl discovery workflows, which read timelines and retrieve user info to support engagement research.

How do I upload media to X and check its processing status before publishing?

Upload media to X and check its processing status by executing xurl media commands, which handle image and video uploads and return processing status details in JSON format.

Do I need preconfigured local credentials to use X API v2 automation tools?

You need preconfigured local credentials stored in the ~/.xurl directory to use X API v2 automation tools, utilizing OAuth 2.0 with auto-refresh while ensuring secrets are never exposed.

Can I hit raw X API v2 endpoints directly for advanced social media automation?

You can hit raw X API v2 endpoints directly for advanced social media automation by using xurl's curl-style commands, providing full control for niche operations beyond standard shortcuts.

What is the best way to manage X engagement like likes and reposts programmatically?

Manage X engagement like likes and reposts programmatically by using xurl CLI commands, which automate liking, reposting, and bookmarking while outputting structured JSON results.