← Back to Skills Marketplace
81
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install x-ads-cli
Description
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...
Usage Guidance
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.
Capability Analysis
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.
Capability Tags
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install x-ads-cli - After installation, invoke the skill by name or use
/x-ads-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 81 downloads so far.
How do I install X Ads CLI?
Run "/install x-ads-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X Ads CLI free?
Yes, X Ads CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does X Ads CLI support?
X Ads CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X Ads CLI?
It is built and maintained by Bin-Huang (@bin-huang); the current version is v1.0.0.
More Skills