無料GitHub で公開日本語紹介

xurl

Xの投稿・返信・検索・DM送信や画像・動画のアップロードを、認証済みのコマンドで行い、投稿内容やフォロワー、認証状態も確認するスキル。

原文原文の説明を見る

xurl CLI for authenticated X posts, replies, reads/search, DMs, media upload, followers, auth status, or raw v2 API calls.

openclaw/openclaw

インストール方法を見る

こんなときに便利

画像や動画付きの投稿をしたいとき
投稿検索やメンション確認
DMを送受信したいとき
フォロワーや認証状態の確認

日本語での紹介

できること

Xへの投稿や情報取得を、xurlのコマンドラインツールで行うスキルです。投稿、返信、引用、削除のほか、投稿の検索や閲覧、タイムライン、メンション、フォロワーの確認に対応します。DMの送受信、画像や動画のアップロード、いいねやブックマーク、フォローなどの操作も扱います。専用コマンドで対応できない処理は、Xのv2 APIを直接呼び出します。

こんなときに便利

エージェントに投稿や返信を頼みたいとき、検索結果やメンションを取得したいときに向いています。成功時の結果はJSONで返るため、取得内容を後続の処理に渡す用途にも使えます。利用するアプリや認証方式をリクエストごとに指定する例もあります。

使い方の例

「この画像をアップロードして、説明文を添えてXに投稿して」
「指定したキーワードで投稿を20件検索して」
「最近のDMと認証状態を確認して」

注意点

xurlの導入とX APIの認証が必要です。秘密情報はコマンドに直接書かず、認証時の入力欄で渡します。--verboseは認証ヘッダーを出力します。APIの利用制限に達した場合は待機が必要です。動画は投稿前に処理状況の確認が必要になる場合があります。

この紹介文は、公開されている SKILL.md をもとに AI（Claude Haiku）が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル（1）

SKILL.md2.6 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

xurl

Use xurl for X API work. Shortcut commands return JSON; raw mode works for any v2 endpoint.

Auth

~/.xurl holds tokens; check auth with xurl auth status instead of reading it.
Pass secrets to auth commands through the prompt, not inline, so they stay out of shell history.
--verbose prints auth headers into tool output.

Common shortcuts

xurl post "Hello world!"
xurl reply POST_ID "Nice."
xurl quote POST_ID "My take"
xurl delete POST_ID
xurl read POST_ID
xurl search "query" -n 20
xurl whoami
xurl user @handle
xurl timeline -n 20
xurl mentions -n 10
xurl like POST_ID
xurl unlike POST_ID
xurl repost POST_ID
xurl unrepost POST_ID
xurl bookmark POST_ID
xurl unbookmark POST_ID
xurl followers -n 20
xurl following -n 20
xurl follow @handle
xurl unfollow @handle
xurl block @handle
xurl unblock @handle
xurl mute @handle
xurl unmute @handle
xurl dm @handle "message"
xurl dms -n 10

POST_ID can be a full https://x.com/<user>/status/<id> URL.

Media

xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "caption" --media-id MEDIA_ID

Videos may need processing; poll media status.

Auth/app management

xurl auth status
xurl auth apps list
xurl auth default
xurl auth default APP_NAME USERNAME
xurl auth apps remove APP_NAME

Per request:

xurl --app APP_NAME /2/users/me
xurl --auth oauth2 /2/users/me

Raw API

xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'

Use raw mode when shortcuts do not cover the endpoint. Keep payloads in temp files for complex JSON.

Output and errors

JSON stdout on success.
Non-zero exit on API/auth/network errors.
401/403: auth, scope, or app mismatch; check xurl auth status.
429: rate limited; back off.
Media upload failures: check file type/size and media processing status.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ