安装

先决条件

你需要安装Node.js。它自带了npx。

选项1：NPX（所有代理人）

支持的 --target 值：claude、gemini、codex、opencode、anti-gravity、openclaw、hermes

选项2：原生插件（仅限Claude代码）

在你的Claude Code终端内执行这两个命令：

选项3：Claude桌面应用

步骤1：下载 点击该仓库的 GitHub 页面上的 代码→下载 ZIP。

步骤2：安装

1. 打开Claude桌面 >自定义>技能> + >上传技能
2. 丢弃下载的压缩包或解压文件夹

概述

Meta Ads 技能是一项全面的、面向生产环境的开放代码技能，旨在赋予大型语言模型和人工智能代理专家级能力，以协调 Varnan-Tech Meta Ads MCP 服务器。

通过运用这项技能，经纪人将转变为媒体采购专家。它将准确知道如何安全认证、探索广告结构、排查活动表现（如CPA峰值）、发现新受众，并将庞大的Meta API JSON负载格式化为美观易读的降价报告。

---

特工们：如何高效使用这项技能

Meta Ads Agentic Skill

Installation

Prerequisites

You need Node.js installed. It comes with npx built in.

Option 1: npx (All Agents)

npx "@opendirectory.dev/skills" install meta-ads-skill --target claude

Supported --target values: claude, gemini, codex, opencode, anti-gravity, openclaw, hermes

Option 2: Native Plugin (Claude Code Only)

Run these two commands inside your Claude Code terminal:

# Add the OpenDirectory marketplace
/plugin marketplace add Varnan-Tech/opendirectory

# Install a skill directly
/plugin install meta-ads-skill@opendirectory-marketplace

Option 3: Claude Desktop App

Step 1: Download Click Code → Download ZIP on this repo’s GitHub page.

Step 2: Install

1. Open Claude Desktop > Customize > Skills > + > Upload a skill
2. Drop the downloaded zip or extracted folder

Overview

The Meta Ads Skill is a comprehensive, production-ready OpenCode skill designed to give LLMs and AI agents expert-level capabilities to orchestrate the Varnan-Tech Meta Ads MCP Server.

By using this skill, an agent transforms into an Expert Media Buyer. It will know exactly how to safely authenticate, explore ad structures, troubleshoot campaign performance (like CPA spikes), discover new audiences, and format massive Meta APIs JSON payloads into beautiful, readable markdown reports.

---

For Agents: How to Use This Skill Efficiently

This skill is designed using a Progressive Disclosure (Hub-and-Spoke) architecture to maximize context window efficiency:

1. The Hub (SKILL.md): The primary entry point. It provides strict guardrails, safety protocols, and the authentication troubleshooting workflow.
2. The Spokes (references/ & scripts/):
   • When you need to perform a specific task (e.g., investigating a CPA spike), read references/workflows.md for the exact step-by-step orchestration strategy.
   • When presenting data to the user, read references/report_templates.md to strictly follow the required Markdown layout.
   • Data Parsing: Meta Ads JSON responses are massive. Always use the provided scripts/formatters.py to condense raw JSON from get_campaigns, get_adsets, or get_insights into clean markdown tables before reasoning over them.

Strict Agent Guardrails

• Context Protection: ALWAYS default to time_range="last_7d" for insights. ALWAYS use limit=10 for listing campaigns/adsets initially.
• Safety First: NEVER execute state-changing tools (create_campaign, update_campaign, clear_database, reset_database) without explicitly showing the parameters to the user and waiting for their affirmative confirmation.

---

Installation & Setup of the Meta Ads MCP