← Back to Skills Marketplace
85
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install meta-ads-open-cli
Description
Meta Ads data analysis and reporting via meta-ads-open-cli. Use when the user wants to check Meta/Facebook/Instagram ad performance, pull campaign/ad set/ad...
Usage Guidance
Before installing or using this skill: 1) Treat the npm package name as unverified—look up the package on npmjs.org (publisher, README, weekly downloads, last publish) and inspect its source code or repository before running `npm install -g`. Prefer installing in a container/VM or using a non-global install for review. 2) Provide an OAuth token with the least-privilege scopes required (avoid ads_management if only reading insights). Use the per-command `--credentials <path>` or short-lived tokens rather than storing long-lived tokens in ~/.config. 3) Ask the skill author/publisher for a homepage/repo and to declare META_ADS_ACCESS_TOKEN (and any other env vars) in the registry metadata. 4) Verify the CLI truly enforces read-only behavior for the scopes you grant. 5) If you lack the ability to review the npm package, do not install globally and consider running queries through an approved, known Meta integration instead.
Capability Analysis
Type: OpenClaw Skill
Name: meta-ads-open-cli
Version: 1.0.0
The skill bundle provides instructions for an AI agent to interface with the 'meta-ads-open-cli' tool for Meta Ads reporting and analysis. The instructions in SKILL.md are well-structured, covering authentication, command usage, and workflow guidance consistent with the tool's stated purpose. No evidence of malicious intent, data exfiltration, or prompt injection was found; the referenced CLI is a legitimate open-source project (github.com/Bin-Huang/meta-ads-open-cli).
Capability Tags
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions: the SKILL.md documents a CLI for the Meta Marketing API with commands for ad accounts, insights, creatives, pixels, and leads. The required capabilities described (reading ad accounts, insights, leads) are coherent with the stated purpose.
Instruction Scope
Runtime instructions are focused on querying Meta data and include concrete CLI commands and authentication options. They do not direct the agent to read unrelated system files or to transmit data to third-party endpoints. One point to note: the doc calls the tool 'read-only' but also lists scopes such as ads_management, which can enable management operations — this should be confirmed with the CLI author.
Install Mechanism
The SKILL.md suggests installing via `npm install -g meta-ads-open-cli`. The skill package metadata in the registry has source = unknown and no homepage. Because the skill points to an unverified npm package name (no provided source or homepage), installing it globally could run arbitrary code. The skill itself has no install spec in the registry, so the installer step is user-driven and not constrained by the platform—this increases operational risk unless you verify the package.
Credentials
The registry lists no required env vars or primary credential, but SKILL.md expects a Meta OAuth token (META_ADS_ACCESS_TOKEN) or a credentials file (~/.config/meta-ads-open-cli/credentials.json) and enumerates several sensitive API scopes (ads_read, ads_management, leads_retrieval, business_management, etc.). This is a mismatch: the skill will need a sensitive credential though none is declared in metadata. The requested token grants access to potentially large amounts of ad/account data and some scopes can enable write actions — users should verify the minimal scopes needed and avoid providing broad tokens.
Persistence & Privilege
Skill is instruction-only (no install spec or code written by the platform) and registry flags do not request always:true. It does reference a local credentials file, but the skill metadata does not grant itself persistent system privileges. No indication the skill will modify other skills or global agent config.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install meta-ads-open-cli - After installation, invoke the skill by name or use
/meta-ads-open-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of meta-ads-open-cli skill.
- Provides read-only Meta/Facebook/Instagram ads data analysis and reporting via CLI.
- Supports querying ad account structure, campaign/ad set/ad insights, creatives inspection, audience analysis, pixel event checks, and lead form retrieval.
- Details authentication methods, permissions, output format, and account/campaign hierarchy.
- Includes extensive examples for command usage, common insights fields, and breakdowns.
- CLI outputs pretty-formatted JSON, with compact mode and cursor-based pagination support.
Metadata
Frequently Asked Questions
What is Meta Ads CLI?
Meta Ads data analysis and reporting via meta-ads-open-cli. Use when the user wants to check Meta/Facebook/Instagram ad performance, pull campaign/ad set/ad... It is an AI Agent Skill for Claude Code / OpenClaw, with 85 downloads so far.
How do I install Meta Ads CLI?
Run "/install meta-ads-open-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Meta Ads CLI free?
Yes, Meta Ads CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Meta Ads CLI support?
Meta Ads CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Meta Ads CLI?
It is built and maintained by Bin-Huang (@bin-huang); the current version is v1.0.0.
More Skills