← 返回 Skills 市场
81
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install x-ads-cli
功能描述
X Ads data analysis and reporting via x-ads-cli. Use when the user wants to check X/Twitter ad performance, pull campaign/line item/promoted tweet stats, exp...
安全使用建议
Before installing or enabling this skill: 1) Verify the x-ads-cli package provenance (official repo or publisher) — do not blindly npm install a package with no homepage. 2) Expect to supply four OAuth credentials or a credentials file; treat these as sensitive secrets and only provide them if you trust the CLI's origin. 3) Prefer passing a per-command credentials file (the --credentials flag) or using least-privilege tokens rather than storing tokens in a shared home config. 4) Because the registry metadata does not list the required env vars, consider this a metadata/packaging oversight — ask the skill author for a source URL or signed release before granting access. 5) If you cannot verify the package source, do not install it globally; consider running it in an isolated environment (container/VM) and review what network calls it makes.
功能分析
Type: OpenClaw Skill
Name: x-ads-cli
Version: 1.0.0
The skill provides a legitimate interface for the `x-ads-cli` tool to perform X/Twitter Ads data analysis. The instructions in `SKILL.md` correctly guide the agent through account discovery, campaign management, and analytics retrieval using standard OAuth 1.0a authentication. There is no evidence of malicious intent, data exfiltration, or prompt injection; the tool's reliance on environment variables and local configuration files for credentials is standard practice for CLI-based integrations.
能力标签
能力评估
Purpose & Capability
The SKILL.md behavior (query ad accounts, campaigns, line items, stats) aligns with the skill name and description — the advertised capabilities are coherent for an X Ads reporting tool.
Instruction Scope
The runtime instructions reference four OAuth 1.0a credentials (API Key/Secret, Access Token/Secret) and a credentials file (~/.config/x-ads-cli/credentials.json), but the skill registry metadata lists no required environment variables or credentials. The instructions also instruct the agent/user to run external commands (x-ads-cli) and to install an npm package if missing. SKILL.md therefore accesses sensitive data and external programs not reflected in the metadata.
Install Mechanism
There is no install spec in the registry (instruction-only), but the doc tells users to run 'npm install -g x-ads-cli' if the CLI is missing. Installing an npm package globally is a reasonable deployment method for a CLI, but it introduces supply-chain risk if the package provenance is unknown. The skill does not provide a verified source (homepage/GitHub) for the package.
Credentials
The tool legitimately needs OAuth credentials for X Ads, but the registry metadata declares no required env vars or primary credential while SKILL.md expects X_ADS_API_KEY, X_ADS_API_SECRET, X_ADS_ACCESS_TOKEN, and X_ADS_ACCESS_TOKEN_SECRET and/or a credentials file. That mismatch means automated permission checks could underreport what the skill needs; these are sensitive secrets and should be declared.
Persistence & Privilege
The skill does not request always:true and does not declare system-wide persistence. It does read a credentials file in the user's home config directory (expected for CLI tools). Autonomous invocation is allowed by default — combine that with credential access only if you trust the skill/package.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install x-ads-cli - 安装完成后，直接呼叫该 Skill 的名称或使用
/x-ads-cli触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of x-ads-cli skill for X/Twitter Ads API analysis
- Provides read-only CLI for querying X Ads (Twitter Ads) accounts, campaigns, line items, promoted tweets, creatives, targeting, custom audiences, billing, and conversion events.
- Supports synchronous analytics/statistics for campaigns, line items, promoted tweets, media, funding instruments, and organic tweets.
- Native OAuth 1.0a signing in Node.js with multiple ways to provide credentials.
- Outputs pretty-printed or compact JSON for all commands.
- Detailed command and options reference included for quick access and onboarding.
- Handles X Ads API microcurrency format and cursor-based pagination.
元数据
常见问题
X Ads CLI 是什么？
X Ads data analysis and reporting via x-ads-cli. Use when the user wants to check X/Twitter ad performance, pull campaign/line item/promoted tweet stats, exp... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 81 次。
如何安装 X Ads CLI？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install x-ads-cli」即可一键安装，无需额外配置。
X Ads CLI 是免费的吗？
是的，X Ads CLI 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
X Ads CLI 支持哪些平台？
X Ads CLI 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 X Ads CLI？
由 Bin-Huang（@bin-huang）开发并维护，当前版本 v1.0.0。
推荐 Skills