xurl

Run xurl CLI commands to post, search, and message on X with JSON output.

Updated May 16, 2026
One-click install
npx skills add https://github.com/jaredcroxton/hermes-mirror --skill xurl-jaredcroxton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/jaredcroxton/hermes-mirror/tree/main/agents/skills/social-media/xurl
Command: npx skills add https://github.com/jaredcroxton/hermes-mirror --skill xurl-jaredcroxton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates common X (Twitter) API tasks without browser scraping by letting you run the official xurl CLI and receive structured JSON output.

Core Features & Use Cases

  • Post, reply, quote, and delete using X API v2 actions backed by xurl shortcuts.
  • Search and read timelines (home timeline, mentions, user info) for research, monitoring, and social listening.
  • Engage and manage presence (like, repost, bookmark, follow, block, mute) and handle DMs plus media uploads for posts.
  • Use case: collect recent posts for a brand keyword, select high-signal results, then engage (like/reply) or upload media for a follow-up post—all driven by API calls.

Quick Start

Run xurl search "from:your_handle" -n 5 to fetch the latest posts as JSON.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I automate X API posts and searches to return JSON?

You can automate X API posts, searches, and direct messages to return JSON by running the xurl CLI, which structures X API v2 responses for machine-readable workflows. This enables automated social listening and engagement without browser scraping.

Do I need my own OAuth credentials to use the X API v2 for direct messaging?

Yes, you need user-managed OAuth credentials persisted locally in the ~/.xurl directory to authenticate X API v2 actions for direct messaging. The system includes guardrails that prevent credential exposure and forbid verbose auth flags during sessions.

Can I upload media and post replies on X using API automation?

Yes, you can upload media and post replies on X using API automation by executing xurl CLI shortcuts backed by X API v2 actions. This supports creating posts, quoting, deleting, and handling media uploads for follow-up content.

What's the best way to collect recent posts for a brand keyword on X?

The best way to collect recent posts for a brand keyword on X is using the xurl search functionality, which queries the X API v2 and returns structured JSON results. You can then parse this output to select high-signal results for monitoring and engagement.

How does social listening work with JSON results from the X API?

Social listening with JSON results works by querying timelines, mentions, and user info via the xurl CLI, which returns structured data from the X API v2. This allows automated systems to parse recent posts, monitor brand keywords, and trigger engagement actions like liking or reposting.

Are there limitations when using xurl for account actions like follow and block?

Limitations when using xurl for account actions include requiring a locally installed xurl binary and forbidding verbose or auth flag usage in agent sessions to prevent credential exposure. It supports follow, block, mute, like, and bookmark actions within these guardrails.