메뉴
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/mateaix/mateclaw --skill x-intel명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
| name | x_intel |
| description | Read X (Twitter) posts, search, timelines and user profiles via the official xurl CLI. |
| nameZh | X 情报采集 |
| nameEn | X Intel |
| version | 1.0.0 |
| icon | 🐦 |
| author | MateClaw |
| optional | true |
| tags | ["x","twitter","social-media","research","xurl"] |
| platforms | ["linux","macos"] |
| dependencies | {"commands":["xurl"],"tools":["execute_shell_command"]} |
x_intel lets an agent pull posts, search results, timelines and user profiles from X (Twitter) through xurl, the X developer platform's official CLI. This skill is read-only by design — it intentionally omits posting, replying, deleting, DM-sending and any other write surface. For a separate publishing skill, see follow-up work.
Use this skill for:
from:user, lang:en, #hashtag, ...)Critical rules when invoked inside an agent session:
~/.xurl into chat context. It is a YAML token store.--verbose / -v — it prints auth headers to stdout.xurl auth status (status only, no secrets).Forbidden flags in any agent-issued command (each accepts inline secrets):
--bearer-token, --consumer-key, --consumer-secret, --access-token, --token-secret, --client-id, --client-secret.
App registration and the OAuth 2.0 PKCE flow must be performed by the user outside the agent session (see "User setup" below). Tokens persist in ~/.xurl (YAML); OAuth 2.0 refreshes automatically.
The agent should verify, not install. Direct the user to install if missing.
# Shell script (Linux + macOS, installs to ~/.local/bin, no sudo)
curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash
brew install --cask xdevplatform/tap/xurl
go install github.com/xdevplatform/xurl@latest
Verify:
xurl --help
xurl auth status
The agent must not perform these steps — they involve pasting secrets. Direct the user to this section verbatim.
http://localhost:8080/callback and the app type to Web app, automated app or bot.xurl auth apps add my-app --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET
xurl auth oauth2 --app my-app
UsernameNotFound or a 403 on the post-OAuth /2/users/me lookup, pass the handle explicitly (xurl v1.1.0+):
xurl auth oauth2 --app my-app YOUR_HANDLE
xurl auth default my-app
xurl auth status
xurl whoami
Most common mistake: omitting
--app my-appfromxurl auth oauth2. The OAuth token then lands in the built-indefaultprofile, which has no client-id/client-secret, and every later read fails. Re-runxurl auth oauth2 --app my-appandxurl auth default my-appto fix.
All commands return JSON to stdout. The agent parses JSON directly; no extra tooling needed.
| Action | Command |
|---|---|
| Who is the bound account | xurl whoami |
| Look up a user | xurl user @handle |
| Read one post (ID or URL) | xurl read POST_ID |
| Search posts | xurl search "QUERY" -n 10 |
| Home timeline | xurl timeline -n 20 |
| Mentions of bound account | xurl mentions -n 20 |
| Bookmarks list | xurl bookmarks -n 20 |
| Likes list | xurl likes -n 20 |
| Following list | xurl following -n 50 |
| Followers list | xurl followers -n 50 |
| Another user's graph | xurl following --of HANDLE -n 20 |
| Auth status | xurl auth status |
Notes:
POST_ID accepts a full https://x.com/user/status/... URL — xurl extracts the ID.@.X's search supports operators inside the quoted query string:
xurl search "from:elonmusk -is:retweet" -n 20
xurl search "#buildinpublic lang:en since:2026-01-01" -n 25
xurl search "OR" -n 10 # literal OR — must be quoted
xurl search "(rust OR go) lang:en" -n 10
xurl search "to:NASA -is:reply" -n 10
Common operators: from:, to:, @, #, is:retweet, is:reply, is:quote, lang:, since:, until:, has:media, has:links. See the X search syntax docs for the full list.
For anything beyond the shortcuts, hit any v2 GET endpoint directly:
# Public user fields
xurl /2/users/by/username/elonmusk?user.fields=public_metrics,description,verified
# Single tweet with metrics + author expansion
xurl /2/tweets/1234567890?tweet.fields=public_metrics,created_at&expansions=author_id
# Recent search with extra fields (paid tier)
xurl /2/tweets/search/recent?query=langchain&tweet.fields=created_at,public_metrics&max_results=25
# Full URLs also work
xurl https://api.x.com/2/users/me
Streaming endpoints are auto-detected; force with -s if needed. Streaming endpoints can be expensive — do not start one without confirming intent with the user.
xurl user @handle
xurl /2/users/by/username/handle?user.fields=public_metrics,description,verified,created_at
xurl following --of handle -n 20 # who they pay attention to
xurl search "topic lang:en -is:retweet" -n 25
# Pick interesting IDs from the JSON, then drill in:
xurl read 1234567890
xurl user @ORIGINAL_POSTER
xurl whoami
xurl mentions -n 20
xurl timeline -n 20
xurl bookmarks -n 10
xurl read https://x.com/user/status/1234567890
# Conversation expansion via raw v2
xurl /2/tweets/search/recent?query=conversation_id:1234567890&max_results=25
Every command emits X API v2 shape JSON to stdout:
{
"data": { "id": "1234567890", "text": "Hello world!" },
"includes": { "users": [{ "id": "...", "username": "..." }] }
}
Errors are also JSON:
{ "errors": [ { "message": "Not authorized", "code": 403 } ] }
The non-zero exit code distinguishes errors from empty results.
xurl --help (the command exists) and xurl auth status (the user has at least one app with oauth2 tokens, marked ▸ as default).auth status output before any other command. If the default app shows oauth2: (none) but a non-default app has valid tokens, instruct the user to run xurl auth default <that-app> — this is the most common config glitch and does not require a re-login.auth status shows no apps or no tokens, stop. Tell the user to follow the "User setup" section. Do not attempt to register apps or run any auth flow yourself.xurl whoami / xurl user @handle / xurl search ... -n 3) to confirm reachability and the request shape.~/.xurl content back into the conversation, even when troubleshooting.| Symptom | Cause | Fix |
|---|---|---|
auth status shows oauth2: (none) on default | Token saved to built-in default profile (no client-id/secret) | Re-run xurl auth oauth2 --app my-app then xurl auth default my-app |
unauthorized_client during OAuth | App type set to "Native App" in X dashboard | Change to "Web app, automated app or bot" |
UsernameNotFound / 403 right after OAuth | X not returning username from /2/users/me | xurl auth oauth2 --app my-app YOUR_HANDLE (xurl v1.1.0+) |
| 401 on every read | Token expired or wrong default app | Check xurl auth status — verify ▸ points to the app with oauth2 tokens |
client-forbidden / client-not-enrolled | X platform enrollment | Developer dashboard → Apps → Manage → Production environment |
CreditsDepleted | $0 balance on X API | Buy credits in Developer Console → Billing |
| 429 on search/timeline | Hit per-endpoint rate limit | Pause, retry with smaller -n, or wait for the reset window |
xurl auth oauth2.xurl --app NAME ... runs one read against a specific app without changing the default.~/.xurl is YAML. Treat it like a private key. Never read or send it to LLM context.Use the optional iOfficeAI/OfficeCLI engine for advanced inspection, validation, copy-on-write editing, template merge, or visual rendering of existing .docx, .xlsx, and .pptx files. Prefer MateClaw's built-in renderDocx/renderXlsx/renderPptx tools for simple new documents. Use this skill when preserving an existing template, modifying complex Office structure, checking formatting issues, validating OpenXML, or rendering a document for visual QA. This integration targets https://github.com/iOfficeAI/OfficeCLI, not the unrelated prompt-generation project with the same name.
当需要主动向某个渠道会话单向推送消息时使用（企业微信、钉钉、飞书、Telegram、Discord、QQ、Slack 等）。适用于任务完成通知、定时提醒告警、异步结果回推等场景。先用 list_channel_sessions 查询目标会话，再用 send_channel_message 发送。
公众号图文创作 / 推文 / 官方号文章 (official account article) — 端到端：选题→搜集→成文→配图→去AI化→公众号内联样式排版→交付/草稿箱。honors user persona & style memory.
SOC 직업 분류 기준