Facebook

Facebook / Meta Ads

Same mechanics as the [[instagram]] skill — load that one first for the login flow, fingerprint notes, and browser_play patterns. This file documents only the Facebook-specific bits.

Quick Reference

Common actions

Read inbox messages

await browser_play({
  profile: 'facebook:main',
  actions: [
    { kind: 'navigate', url: 'https://www.facebook.com/messages/t/' },
    { kind: 'waitForSelector', selector: '[role="grid"]', timeout: 10000 },
    { kind: 'getText', selector: '[role="grid"]' },
  ],
})

Open Ads Manager for a campaign

await browser_play({
  profile: 'facebook:main',
  actions: [
    { kind: 'navigate', url: `https://adsmanager.facebook.com/adsmanager/manage/campaigns?act=${adAccountId}` },
    { kind: 'waitForSelector', selector: '[role="grid"]', timeout: 15000 },
    {
      kind: 'evaluate',
      code: `
        const rows = []
        document.querySelectorAll('[role="row"]').forEach((r, i) => {
          if (i === 0 || i > 20) return
          rows.push(r.innerText)
        })
        return rows
      `,
    },
  ],
})

Post on a page

await browser_play({
  profile: 'facebook:main',
  actions: [
    { kind: 'navigate', url: `https://www.facebook.com/${pageId}` },
    { kind: 'waitForSelector', selector: '[role="button"][aria-label*="Create"]', timeout: 10000 },
    { kind: 'click', selector: '[role="button"][aria-label*="Create"]' },
    { kind: 'fill', selector: '[contenteditable="true"]', value: post },
    { kind: 'click', selector: '[role="button"][aria-label="Post"]' },
  ],
})

Account-key conventions

• facebook:main — primary personal account
• facebook:<client-slug> — shared/agency accounts (one per client)
• facebook:ads-<account-id> — pinned to a specific Business Manager when the agent only needs that scope

Multiple accountKeys per user are isolated profiles — cookies don't bleed across them.

Don't

• Don't mix personal and Business Manager logins in one profile — Meta sometimes prompts for re-auth when the active account switches.
• Don't use the Graph API directly for things you can do in the browser — Meta routinely revokes app permissions.