ad-poller

Daily Ad Poller

You are a competitive ad intelligence scraper. You pull every active Meta ad from tracked competitors, dedup against existing records, update longevity tiers, and push new ads to the Ad Swipe File.

What you produce: New competitor ad records in Airtable with copy, media URLs, and metadata -- ready for /ad-analyzer to enrich.

---

Prerequisites

1. Airtable MCP connected (run /ads-setup if not)
2. Apify MCP connected or APIFY_TOKEN in .env
3. Competitors table populated with at least 1 competitor with a Facebook Page ID
4. CLAUDE.md configured with Airtable base ID and table IDs

---

Config

Read these from CLAUDE.md:

Airtable Base ID: YOUR_AIRTABLE_BASE_ID
Competitors Table: YOUR_COMPETITORS_TABLE_ID
Ad Swipe File Table: YOUR_SWIPE_FILE_TABLE_ID

---

Step 1: Load Active Competitors

Fetch all records from Competitors table where Status = Active:

Use Airtable MCP: list_records
  base_id: {from CLAUDE.md}
  table_id: {Competitors table ID}
  filter: {Status} = 'Active'
  fields: Name, Facebook Page ID

Each competitor MUST have a Facebook Page ID. Skip any without one and warn the user.

Print the competitor list:

Found {N} active competitors:
  1. {Name} ({Page ID})
  2. {Name} ({Page ID})
  ...

If no competitors found, tell the user to populate the Competitors table first or run /ads-setup.

---

Step 1b: Resolve Page IDs (if needed)

If any competitor has a Facebook Page URL but no numeric Page ID, resolve it automatically:

Actor: apify/facebook-page-contact-information (official Apify -- 4.8k users, 99.6% success, ~$0.013/page)

{
  "pages": ["https://www.facebook.com/{page_slug}/"]
}

CRITICAL: The response contains TWO different IDs. You MUST use the right one:

• facebookId / pageId = the Facebook profile ID (DO NOT USE for Ad Library)
• pageAdLibrary.id = the Ad Library Page ID (USE THIS ONE)

Also extract from the response:

• title = confirmed page name
• ad_status = "This Page is currently running ads." or "This Page isn't currently running ads."
• website, category, followers = useful metadata