Skip to content

Hainrixz/claude-ads / ads

Free-first paid advertising audit and optimization skill, focused on the 3 platforms where 95% of advertiser spend lives: Meta, Google, TikTok. Guided onboarding (/ads start) saves context once and step-by-step OAuth walkthroughs; continuous coach (/ads next) ranks Quick Wins after each audit. ~158 weighted checks with scoring, parallel agents, industry templates, and AI creative generation.

FileKindSize
SKILL.mdskill md18.6 KB
references/additional-platforms.mdmarkdown3.6 KB
references/audit-history-schema.jsonconfig2.5 KB
references/audit-methodology.mdmarkdown4.3 KB
references/audit-output-schema.jsonconfig4.9 KB
references/benchmarks-cross.mdmarkdown1003 B
references/benchmarks-google.mdmarkdown1.6 KB
references/benchmarks-social.mdmarkdown2.6 KB
references/benchmarks.mdmarkdown929 B
references/bidding-google.mdmarkdown5.2 KB
references/bidding-meta.mdmarkdown1.8 KB
references/bidding-strategies.mdmarkdown989 B
references/bidding-tiktok.mdmarkdown2.0 KB
references/brand-dna-template.mdmarkdown6.9 KB
references/budget-allocation.mdmarkdown5.8 KB
references/compliance-changes-2025-2026.mdmarkdown2.5 KB
references/compliance-platforms.mdmarkdown3.6 KB
references/compliance-privacy.mdmarkdown3.1 KB
references/compliance.mdmarkdown1.6 KB
references/conciencia-schema.jsonconfig5.3 KB
references/conciencia.mdmarkdown5.2 KB
references/conversion-tracking.mdmarkdown1.2 KB
references/copy-frameworks.mdmarkdown8.9 KB
references/gaql-notes.mdmarkdown2.8 KB
references/google-audit-notes.mdmarkdown3.9 KB
references/google-audit.mdmarkdown12.5 KB
references/google-changelog-30d.mdmarkdown3.6 KB
references/google-creative-specs.mdmarkdown3.7 KB
references/image-providers.mdmarkdown4.9 KB
references/mcp-integration.mdmarkdown5.7 KB
references/mcp-meta-integration.mdmarkdown5.8 KB
references/meta-audit.mdmarkdown12.4 KB
references/meta-changelog-30d.mdmarkdown4.0 KB
references/meta-creative-specs.mdmarkdown4.5 KB
references/platform-specs-cross.mdmarkdown1.3 KB
references/platform-specs.mdmarkdown799 B
references/profile-schema.jsonconfig4.5 KB
references/scoring-system.mdmarkdown6.1 KB
references/setup-google.mdmarkdown7.1 KB
references/setup-meta-developers.mdmarkdown4.7 KB
references/setup-meta.mdmarkdown7.0 KB
references/setup-tiktok.mdmarkdown5.2 KB
references/setup-zernio.mdmarkdown4.5 KB
references/tiktok-audit.mdmarkdown10.1 KB
references/tiktok-changelog-30d.mdmarkdown3.5 KB
references/tiktok-creative-specs.mdmarkdown4.8 KB
references/tracking-cross.mdmarkdown1.5 KB
references/tracking-google.mdmarkdown2.8 KB
references/tracking-meta.mdmarkdown2.4 KB
references/tracking-tiktok.mdmarkdown1.5 KB
references/update-cost-warning.mdmarkdown2.0 KB
references/voice-to-style.mdmarkdown3.9 KB
research-sources/README.mdmarkdown883 B
research-sources/claude-research.mdmarkdown3.9 KB
research-sources/gemini-research.mdmarkdown10.2 KB
research-sources/google-audit-checklists.mdmarkdown25.9 KB
research-sources/google-optimization-logic.mdmarkdown11.9 KB
research-sources/google-platform-specs.mdmarkdown16.6 KB

references/setup-meta-developers.md

View on GitHub
# Setup: Meta for Developers account (prerequisite for Meta direct API)

Loaded by `/ads start` Phase D.1 when the user picks Meta direct-API tier
but doesn't yet have a Meta for Developers account.

After completing this walkthrough, return to **`setup-meta.md` Section B** to
finish creating the User Token + System User Token + verifying with
`meta_fetch.py`.

Effort: ~5–10 min including phone verification.

---

## STEP 1 — Go to the developer portal
- **Goal**: open the right onboarding page.
- **Do this**: https://developers.facebook.com → **Get Started** (top right)
  → **Continue as <Facebook user>** (uses the user's existing Facebook
  account; no separate dev account needed).
- **Expect to see**: a "Welcome, developer" landing page.
- **On error**: blank page → log out of Facebook, log back in, then retry.

## STEP 2 — Accept developer policies
- **Goal**: agree to platform terms.
- **Do this**: read + check both boxes (Platform Policy, Developer Policies)
  → **Continue**.
- **Expect to see**: redirect to phone/email verification.

## STEP 3 — Verify phone number
- **Goal**: Meta requires a verified phone for app creation.
- **Do this**: enter mobile number → receive SMS code → enter it.
- **Expect to see**: ✓ phone verified.
- **On error**: SMS doesn't arrive → use a different number; some VOIP
  numbers are blocked. WhatsApp Business numbers work.

## STEP 4 — Pick the "Developer" role (not "Marketer")
- **Goal**: select the right account type.
- **Do this**: when prompted "How will you use Meta for Developers?", pick
  **Developer** (or "Other" → "Developer"). NOT "Marketer" — that's a
  different track without API access.
- **Expect to see**: developer dashboard at developers.facebook.com/apps.

## STEP 5 — Create the first app
- **Goal**: an app shell to add the Marketing API to.
- **Do this**: **My Apps** → **Create App** → use case **Other** → app type
  **Business** → app name "claude-ads" (or any name) → **Create app** →
  enter Facebook password to confirm.
- **Expect to see**: app dashboard with empty product list.
- **On error**:
  - "Consumer" auto-selected and won't let you switch → start over with a
    fresh app; some accounts default oddly.
  - "Business app type unavailable" → user's Facebook account is too new
    (<60 days). Add a Business Manager first at business.facebook.com,
    then retry.

## STEP 6 — Add Marketing API product
- **Goal**: enable the API endpoints `meta_fetch.py` calls.
- **Do this**: in app dashboard → left nav **Add Product** → find
  **Marketing API** → **Set Up**.
- **Expect to see**: Marketing API now in left nav.
- **On error**: "App must be associated with a Business" → in app Settings →
  Basic → assign a Business in the Business Account dropdown.

## STEP 7 — Note App ID + App Secret
- **Goal**: save credentials needed in `setup-meta.md` Step B3.
- **Do this**: app dashboard → Settings → Basic → copy **App ID** (numeric)
  + **App Secret** (click "Show", paste password, copy).
- **Expect to see**: both values saved to a vault / password manager.
- **On error**: "Show" button greyed → user isn't an app admin (only Tester);
  switch roles or use a different Facebook account.

## STEP 8 — Confirm Business Manager link
- **Goal**: ensure the app can act on a real ad account.
- **Do this**: business.facebook.com → Business Settings → Accounts → **Ad
  Accounts**. The ad account the user wants to audit MUST be listed here.
  If not, **Add** → Add an Ad Account → enter the `act_<id>`.
- **Expect to see**: the ad account in the list, status Connected.
- **On error**: "You don't own this ad account" → ad account owner must
  share it via Business Manager → People → Add Partner.

---

## What's next

Back to **`setup-meta.md` Section B Step B2** — generate the User Token in
Graph API Explorer, then proceed through B3–B5 to verify.

The numbers / strings to keep from this walkthrough:

| Field | Where used later |
|-------|------------------|
| App ID | `setup-meta.md` Step B3 (token exchange) |
| App Secret | `setup-meta.md` Step B3 (token exchange) |
| Business name | confirmation only |
| Ad account `act_<id>` | every `meta_fetch.py` call |

---

## Troubleshooting summary

| Symptom | Cause | Fix |
|---------|-------|-----|
| Phone verification fails | VOIP number blocked | Use a real mobile / WhatsApp Business number |
| Can't select "Business" app type | New Facebook account (<60 days) | Add a Business Manager first |
| App Secret "Show" greyed out | Logged-in user is Tester, not Admin | Switch to admin user |
| Marketing API not appearing in product list | App not associated with a Business | Set Business in Settings → Basic |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall