paid-ads-x

Audit, diagnose, and operate X Ads accounts through the NotFair MCP connector.

3.4k|426|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/nowork-studio/toprank --skill paid-ads-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paid-ads-x
Source: https://github.com/nowork-studio/toprank/tree/main/paid-ads/paid-ads-x
Command: npx skills add https://github.com/nowork-studio/toprank --skill paid-ads-x

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing X Ads (Twitter Ads) accounts requires navigating a complex hierarchy of campaigns, line items, and promoted posts, plus tricky details like micro-currency fields and optimization tags that are easy to misread. This Skill gives an AI agent a disciplined workflow to audit live X Ads performance, diagnose issues correctly, and apply approved changes safely without irreversible mistakes.

Core Features & Use Cases

  • Live account audits: Connect through the NotFair MCP x_ads_ tools, verify the account, and pull campaigns, line items, funding, and performance in one broad read.
  • Accurate diagnosis: Correctly interpret *_local_micro money fields, distinguish optimization configuration from attributed conversions, and compare complete equivalent periods with proper currency and date-window discipline.
  • Safe, approval-gated mutations: Preview budget, bid, targeting, and creative changes with dry-run when available, create new entities paused, and verify results with before/after evidence.
  • Use Case: Ask the agent to audit last month's X Ads spend, identify the line item wasting budget, and propose a budget change—it will show current vs. proposed spend, wait for your explicit approval, then confirm the applied change.

Quick Start

Use the paid-ads-x skill to audit my connected X Ads account for the last 30 days and recommend the safest budget improvements.

Frequently Asked Questions about paid-ads-x

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my X Ads account performance with an AI agent?

Connect X Ads through the NotFair MCP, then ask the agent to audit your account. It verifies the connection, pulls campaigns, line items, and performance in one broad read, and reports spend, conversions, and CPA with explicit currency and date windows.

How do I change X Ads campaign budgets safely?

The agent shows the exact account, entity, current value, proposed value, and spend exposure before acting. It uses dry-run previews when available, requires your explicit approval, and confirms the result with before/after evidence or a fresh read.

Does a null primary_web_event_tag mean my X Ads conversions are broken?

No. The primary_web_event_tag describes a line item's optimization configuration, not its attributed performance. The skill reads actual conversion metrics from WEB_CONVERSION performance data instead of inferring zero conversions from the tag.

Why do X Ads spend values look millions of times too large?

X Ads money fields ending in *_local_micro are local-currency units multiplied by 1,000,000. The skill divides these values by 1,000,000 before displaying or comparing them, so reported spend matches your actual currency.

Can the agent launch new X Ads campaigns automatically?

It creates campaigns and line items in a paused state, verifies the configuration, and only activates them after your explicit approval. It prefers pause/enable over irreversible deletion and treats optimization-event changes as learning resets.