Local Contact Harvester

SKILL: Local Contact Harvester
Google Maps exposes phones, websites, and social links for nearly every local business, but Facebook-only SMBs slip through the cracks. One broad Maps sweep plus per-pin detail enrichment turns a map into an import-ready contact database; an optional Facebook Pages sweep catches operators that never surfaced on Maps and merges them in, and an optional Instagram pass verifies and adds public emails. The user chooses which extra platforms run, how deep to sweep, and which region to scope.

You are running this skill on API Direct via its MCP tools. Execute the steps below yourself by calling the named tools in order — values in <angle brackets> come from a previous step. Then deliver the result described at the end.

INPUTS:
  - niche (required): <niche — ASK THE USER>
      The business category to harvest
  - city (required): <city — ASK THE USER>
      City and region to search
  - platforms (optional): (optional — e.g. facebook, instagram)
      Comma-separated list of platforms to run — options: places, instagram, facebook. Omit to run all of them; name specific platforms to limit the run.
  - depth (optional): 20 (default — override if you like)
      How many result pages to sweep on each search (maps to the pages param on search_places and search_facebook_pages). Higher pulls more businesses; defaults to 20.
  - country (optional): (optional — e.g. us)
      ISO country code to scope the Google Maps search and detail lookups for non-US harvests (maps to the country param on search_places and place_details).

PLATFORM SELECTION: some steps are gated with "Only run if {platforms} includes X". If the user supplied a `platforms` value, run only the steps whose platform is listed. If the user did NOT supply `platforms`, run ALL steps — every platform the skill supports.

STEPS:
  1. Tool `search_places` — search_places(query="{niche} {city}", pages=20)
     Core sweep: pull up to ~200 pins (set by 20, default 20 pages; scope with {country} if set), keep only business_status==OPERATIONAL, and collect each place_id, name, and website.
  2. Tool `place_details` — place_details(place_id=<place_id>)
     For each pin extract emails_and_contacts (emails, phone_numbers, instagram/facebook/linkedin) and owner_name, then dedupe rows by phone number and domain.
  3. Tool `instagram_user_profile` — instagram_user_profile(url=<instagram_url>)
     Only run if {platforms} includes instagram: for pins that exposed an Instagram link, pull public_email, followers, and category to enrich and validate the contact record.
  4. Tool `search_facebook_pages` — search_facebook_pages(query="{niche} {city}", pages=20)
     Only run if {platforms} includes facebook: discover local business Facebook Pages for the same niche+city — including operators that never surfaced on Google Maps — and collect each page URL and name.
  5. Tool `facebook_page_details` — facebook_page_details(url=<facebook_page_url>)
     Only run if {platforms} includes facebook: pull phone, email, website, and address from each Page, then merge into the master list and dedupe against the Maps rows by phone number and domain so no business is double-counted.

DELIVER: A deduped, CRM-ready spreadsheet of every {niche} in {city} with name, phone, email, website, owner, and social handles — merged across Google Maps and (optionally) Facebook per the platforms you enable.

Note: each underlying tool call is billed at its normal endpoint price; get_sentiment adds a small per-page surcharge. Page through results as needed but stop once you have enough to deliver the outcome.