skills.rest
eddielueng
eddieluengCOMMUNITY
Explore all skills by this author →
GitHub

xurl

Interact with X/Twitter APIs from the command line using JSON outputs.

1|Updated Apr 14, 2026
Search Tags:#oauth2#social media automation#media upload#twitter api#xurl#dm messaging#search and timelines
One-click install
npx skills add https://github.com/eddielueng/hermes-agent-zh --skill xurl-eddielueng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/eddielueng/hermes-agent-zh/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/eddielueng/hermes-agent-zh --skill xurl-eddielueng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

xurl eliminates the friction of interacting with X/Twitter APIs by providing a single official CLI that returns JSON, so you can automate reads and writes without building custom API clients.

Core Features & Use Cases

  • Posting and engagement: publish posts, replies, quotes, likes, reposts, bookmarks, and deletes using simple subcommands.
  • Discovery and research: search posts and access timelines, mentions, and user info with structured JSON output.
  • Messaging and media: send and list DMs and upload media (images/video) with a supported workflow for retrieving media status.
  • Power-user raw access: perform curl-style requests to any X API v2 endpoint, including streaming endpoints.

Quick Start

Upload a media asset and post with it by telling the agent: "Use xurl to upload photo.jpg, then post 'Check out this photo!' with the returned media id."

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 engagement from the command line?▼

You can automate Twitter posting, replies, likes, and reposts from the command line by using a CLI that outputs JSON. It eliminates the need to build custom API clients for direct v2 endpoint interaction.

Can I upload media and include it in an X API post?▼

Yes, you can upload media assets like images and video via the command line. You then use the returned media ID in your subsequent post command to publish the media natively on X.

How do I search Twitter timelines and mentions and get structured data?▼

You can search posts and access timelines, mentions, and user info with structured JSON output sent directly to stdout. This enables easy parsing for downstream research and automation workflows.

Do I need to set up OAuth2 credentials to use the X API for DMs and posting?▼

Yes, user-managed OAuth2 setup is required. You must configure your credentials safely in a designated directory before executing any posting, engagement, or DM messaging commands.

What is the best way to perform raw curl-style requests to X API v2 endpoints?▼

The best way to perform raw curl-style requests to any X API v2 endpoint, including streaming endpoints, is through a CLI that supports raw access. This provides power-user flexibility without custom client overhead.

Does xurl work for sending and listing direct messages on Twitter?▼

Yes, xurl supports sending and listing direct messages using simple subcommands. It interfaces directly with the X API to manage your DM workflows from the terminal.

Related Skills

Explore More Marketing & Sales Skills→
MoRen9527MoRen9527

xurl

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

Community
Intermediate
antgroupantgroup
34

twitter

Post tweets, retrieve timelines, and manage followers via command-line execution.

Official
Intermediate
masharrattmasharratt
14

CFN Marketing Social Publishing Skill

Automate cross-platform social media publishing via n8n workflows.

Community
Intermediate
pmcdowallpmcdowall

xurl

Manage X/Twitter interactions via authenticated xurl CLI commands and X API v2.

Community
Advanced