openads-ai 0.2.14 → 0.2.15

package/dist/cli.js

@@ -93,8 +93,8 @@ function buildSystemPrompt(config) {
         '- You have direct, live access to Google Ads, Meta Ads, and Google Analytics 4 (GA4) via custom Model Context Protocol (MCP) server tools.',
         '- Whenever the user asks to check campaigns, review metrics, fetch performance data, or analyze active ads, you MUST use the corresponding MCP server tools to query the live platforms.',
         '- NEVER search the local file system, run grep/ripgrep, check Git logs, or read codebase files to search for ad campaign data. The active folder is just the application source code — it contains zero campaign metrics. Campaign data comes ONLY from querying your active MCP server tools.',
-        '- To fetch Meta campaign data: ALWAYS call `get_ad_accounts()` first (takes no parameters) to retrieve the active account ID (e.g., `act_123456789`). Then call `list_campaigns(account_id)` to list campaigns and retrieve active campaign IDs. Finally, call `get_campaign_performance` or `get_insights` using the retrieved IDs. Never guess or omit `object_id` when calling performance tools.',
-        '- You are a highly proactive, self-starting digital marketer. When the user asks to check campaigns or fetch reports, DO NOT ask for permission or prompt them for campaign IDs. IMMEDIATELY call your read-only discovery tools (`get_ad_accounts` followed by `list_campaigns`) to fetch the active IDs and retrieve the data yourself. Be proactive and deliver results instantly rather than hesitating or asking redundant confirmation questions.',
+        '- To fetch Meta campaign data: ALWAYS call `get_ad_accounts()` first (takes no parameters) to retrieve the active account ID. Then call `list_campaigns(account_id)` to list campaigns and retrieve active campaign IDs. Finally, call `get_campaign_performance` or `get_insights` using the retrieved literal IDs. Never guess or omit `object_id` when calling performance tools, and NEVER use generic placeholder tokens like `<your_account_id>` or `act_YOUR_ACCOUNT_ID` under any circumstances.',
+        '- You are a highly proactive, self-starting digital marketer. When the user asks to check campaigns, review metrics, or fetch performance reports, DO NOT stop at listing campaign names, and DO NOT ask for permission or prompt the user for campaign IDs. IMMEDIATELY proceed to query performance or insights (`get_campaign_performance` or `get_insights`) for the discovered active campaign IDs. Deliver a beautiful marketing summary with structured key metrics (spend, impressions, CTR, ROAS, conversions) proactively and instantly rather than hesitating or asking redundant confirmation questions.',
         '- ANTI-LOOP SAFETY RULE: Once a tool (like `get_ad_accounts`) successfully returns its data, NEVER call it again in the same turn. Proceed immediately to the next logical step (e.g. calling `list_campaigns` or `get_campaign_performance`). If you repeat the exact same tool call consecutively, your connection will be flagged. Always move forward and progress through the tool chain.',
     ];
     if (isLaunchMode) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openads-ai",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "Open-source AI command center for digital marketers. Audit campaigns, write ad copy, and build strategies — from your terminal.",
   "main": "dist/cli.js",
   "bin": {

package/skills/ads/meta-ads.md

@@ -43,13 +43,23 @@ Read `product-marketing.md` first to understand the product context.
 
 ## MCP Tools to Use & Execution Sequence
 
-When Meta Ads MCP is connected, you must follow this exact sequence to retrieve campaign data and avoid validation errors:
+When Meta Ads MCP is connected, you must follow this exact sequence to retrieve campaign performance data proactively without stopping or using placeholders:
 
-1. **Discover Ad Accounts**: First, call `get_ad_accounts()` (no parameters required) to get the user's connected ad accounts and retrieve their `account_id` (e.g., `act_123456789`).
-2. **List Campaigns**: Once you have the `account_id`, call `list_campaigns(account_id: "act_YOUR_ACCOUNT_ID")` to get a list of active and inactive campaigns with their names and `id`s.
-3. **Fetch Performance & Insights**:
-   - To check overall campaign metrics, call `get_campaign_performance(object_id: "YOUR_CAMPAIGN_ID", level: "CAMPAIGN")`.
-   - Or to check account-wide metrics, call `get_campaign_performance(object_id: "act_YOUR_ACCOUNT_ID", level: "AD_ACCOUNT")`.
-   - To retrieve detailed ads/adset insights, breakdowns, or custom metrics, call `get_insights(object_id: "YOUR_CAMPAIGN_ID", level: "CAMPAIGN")`.
+1. **Discover Ad Accounts**: First, call `get_ad_accounts()` (takes no parameters) to retrieve the active account ID (e.g. `act_527976914813519`).
+2. **List Campaigns**: Call `list_campaigns(account_id: "act_527976914813519")` (using the literal account ID retrieved in Step 1) to get a list of active and inactive campaigns.
+3. **Fetch Performance & Insights**: Do NOT stop at listing the campaigns or ask for permission. Proceed immediately to retrieve performance/insights for the discovered active campaign IDs.
+   - For overall campaign performance metrics, call `get_campaign_performance(object_id: "YOUR_CAMPAIGN_ID", level: "CAMPAIGN")` using the literal campaign ID (e.g., `23845056436410209`).
+   - For detailed adset/ad level insights or breaking down statistics, call `get_insights(object_id: "YOUR_CAMPAIGN_ID", level: "CAMPAIGN")`.
+4. **Present Results**: Structure and format the retrieved insights into a beautiful marketing summary featuring spend, impressions, CTR, ROAS, and conversions.
 
-**CRITICAL RULE**: Never guess campaign IDs or call `get_campaign_performance` or `get_insights` without an `object_id`. Always query `get_ad_accounts()` first, then `list_campaigns()`, and finally fetch performance.
+### Execution Example Flow
+```mermaid
+graph TD
+    A["get_ad_accounts()"] -->|Returns act_527976914813519| B["list_campaigns(account_id: 'act_527976914813519')"]
+    B -->|Returns Campaign 23845056436410209| C["get_campaign_performance(object_id: '23845056436410209')"]
+    C -->|Fetch Metrics Proactively| D[Format & Display Beautiful Marketing Summary]
+```
+
+**CRITICAL RULES**:
+- **NEVER** use generic placeholder strings like `<your_account_id>` or `act_YOUR_ACCOUNT_ID` in tool arguments under any circumstances. Always extract the literal IDs from previous tool outputs.
+- **NEVER** stop at listing campaigns or ask the user "Would you like me to fetch performance details?"—always proactively fetch the performance/insights of the active campaigns.