mcpField
A
ad-audiences

ad-audiences

github.com/cold-iqMarketing & growth347 installsUpdated 2w ago
Repository

About ad-audiences

ad-audiences is a marketing skill for preparing ABM ad audiences and coordinating ads with outbound sales. ColdIQ supplies hashed emails, identity resolution, and company data; audience creation and campaign execution remain in the ad platforms.

Key features

  1. 01Get SHA-256 emails for ad targeting
  2. 02Resolve identities and find work emails
  3. 03Search for ABM target companies
  4. 04Enrich engaged contacts and companies
  5. 05Coordinate outbound using ad engagement

Use cases

  1. 01Prepare matched audiences for LinkedIn, Meta, or Google Ads
  2. 02Build target-company lists and define exclusions
  3. 03Schedule sales follow-up from clicks or video views

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cold-iq/coldiq-marketplace-skills --skill ad-audiences

After installing, type/ad-audiencesin Claude Code to confirm it loaded.

Details

From the project README

Ad Audiences & ABM Lists

Turn your prospect data into matched ad audiences and coordinate ads with outbound. ColdIQ supplies the hashed emails ad platforms need for matched/custom audiences and resolves identities for targeting; the platform setup (LinkedIn/Meta/Google Ads Manager) stays in those tools.

ColdIQ Marketplace Endpoints

TaskMethodPathCreditsEndpoint IDNotes
Hashed email for ad targetingPOST/v1/limadata/find/hashed-email1limadata.find.hashed_emailSHA-256 emails for matched audiences
Resolve identity (social URLs)POST/v1/limadata/find/identity-resolution2limadata.find.identity_resolutionname+company/email → LinkedIn etc.
Reverse-email → profilePOST/v1/limadata/find/reverse-email-lookup5limadata.find.reverse_email_lookupEnrich an engaged email
Find work email (to hash)POST/v1/limadata/find/work-email1limadata.find.work_emailGet the email first if missing
Enrich engaged accountPOST/v1/limadata/enrich/company1limadata.enrich.companyFirmographics for an engaging account
Build the target company listPOST/v1/ai-ark/companiesper resultai_ark.companies.searchSource the ABM list

Build a matched audience (for ads)

Ad platforms match custom audiences on hashed emails. From a target list:

  1. If you only have name+company, find the email first. → POST /v1/limadata/find/work-email · 1 cr · limadata.find.work_email
  2. Produce the SHA-256 hashed email the ad platform expects. → POST /v1/limadata/find/hashed-email · 1 cr · limadata.find.hashed_email
  3. Upload the hashes to LinkedIn/Meta/Google as a matched/custom audience (in the ad platform).

Company lists match at 95–100% on LinkedIn vs 30–70% for contact lists — prefer company lists for ABM reach, and use hashed-email audiences for precise person-level retargeting.

ABM target list + exclusions

  1. Source the target companies, then tier them (see tam-scoring). → POST /v1/ai-ark/companies · per result · ai_ark.companies.search
  2. Always build exclusions: competitors, existing customers, wrong seniority, login-page visitors.
  3. Separate personas into their own campaigns; for 500+ employee accounts exclude managers.
  4. Audience Expansion OFF by default; impression cap ~500/company/7 days.

Ads + outbound sync (engagement as triggers)

Use ad engagement to time outbound:

SignalActionTiming
Ad click from a target accountPersonalized emailwithin 24h
50%+ video viewAdd to warm sequencewithin 48h
High impression frequencyCall referencing the contentwithin 1 week
Lead-form open (not submitted)Retarget + sales follow-upwithin 24h
Pricing-page visit from adPriority outbound with offerimmediate

When you only have an engaging email or account, enrich it before reaching out: → POST /v1/limadata/find/reverse-email-lookup · 5 cr · limadata.find.reverse_email_lookup → POST /v1/limadata/find/identity-resolution · 2 cr · limadata.find.identity_resolution

Coordinated ABM cadence: Wk1–2 awareness ads → Wk3–4 retarget engaged + personalized email → Wk5–6 case-study ads + calls referencing content → Wk7–8 CTA ads + demo offer.

Notes

  • ColdIQ provides the audience data (hashed emails, identities, firmographics); creating the audience and running ads happens in the ad platform.
  • Hash on the find endpoint, not client-side, so the hashing matches what the platform expects.

Comments

Markdown supported