skills.rest
Mateus2411
Mateus2411COMMUNITY
Explore all skills by this author →
GitHub

xurl

Post, search, and message on X via the xurl CLI with JSON output.

Updated May 10, 2026
Search Tags:#oauth2#media upload#x api#xurl#direct messages#social media posting#twitter automation
One-click install
npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill xurl-mateus2411
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/Mateus2411/Hermes-PersonalBot/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill xurl-mateus2411

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

xurl removes the friction of interacting with the X (Twitter) API by providing a single CLI that handles common actions and raw v2 endpoint access while returning structured JSON results.

Core Features & Use Cases

  • X API actions via simple commands: post, reply, quote, delete, like, repost, bookmark, follow, block, mute, and DM.
  • Search, timelines, and mentions: query posts and read timelines in a consistent JSON format.
  • Media upload support: upload images and videos and then attach returned media IDs to posts.
  • Raw v2 endpoint access: perform any X API v2 request using curl-style options when a shortcut command isn’t available.

Quick Start

Ask it to search for recent posts about "golang" and return the latest results as JSON by running xurl search "golang" -n 10.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I automate Twitter posting and direct messages without manually writing API calls?▼

You can automate Twitter posting and direct messages by using the xurl CLI to handle X API actions like post, reply, quote, and DM. It bypasses manual API crafting by returning structured JSON outputs for social automation workflows.

How do I search recent posts on X and retrieve the results as structured JSON?▼

To search recent posts on X and retrieve JSON results, you can use the xurl CLI search command. For example, querying xurl search "golang" -n 10 fetches the latest matching posts in a consistent JSON format.

Do I need OAuth2 tokens to use the xurl CLI for social media posting?▼

Yes, you need authenticated access via OAuth2 tokens stored locally in the ~/.xurl directory. This local xurl installation and token setup is required before executing any X API v2 requests or shortcut commands.

Can I upload media images and videos to X and attach them to my posts?▼

Yes, you can upload images and videos using the media upload support. The CLI returns media IDs which you can then attach to your posts, streamlining the process of enriching your social media content.

What is the best way to access raw X API v2 endpoints when a shortcut command is not available?▼

When a shortcut command is unavailable, you can perform any raw X API v2 request using curl-style options. This allows direct interaction with the X API v2 endpoints while maintaining consistent JSON output.

How does xurl handle retrieving timelines and mentions for social moderation?▼

xurl retrieves timelines and mentions by querying the X API and returning the data in a consistent JSON format. This structured output supports social moderation workflows by enabling easy parsing of engagement data.

Related Skills

Explore More Marketing & Sales Skills→
MoRen9527MoRen9527

xurl

Send authenticated requests to the X API v2 via command-line interface.

Community
Intermediate
wulaosijiwulaosiji
28

feishu-card-parser

Parse Feishu Interactive Card JSON into Markdown and plain text.

Community
Basic
Mueza-EjazMueza-Ejaz

post-to-social-media

Create, schedule, and publish social media posts on Facebook and Instagram.

Community
Advanced
hammadparveezhammadparveez

xurl

Manage X API v2 interactions including auth, posting, searching, messaging via CLI.

Community
Intermediate