Local Buying-Intent Lead Capture

SKILL: Local Buying-Intent Lead Capture
People announce life events and service needs in real time — in geo-tagged Facebook posts and neighborhood groups, in their city subreddit, and on X — before they ever Google a provider. This skill geofences a metro and mines those channels for that live intent, and lets you choose which platforms to run.

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:
  - city (required): <city — ASK THE USER>
      Target metro or city to geofence
  - intent_phrase (required): <intent_phrase — ASK THE USER>
      The buying-intent phrase a local would post
  - group_url (optional): (optional — e.g. https://www.facebook.com/groups/austinnewcomers)
      URL of a local Facebook community/newcomers group to also mine (Facebook only)
  - platforms (optional): (optional — e.g. facebook, reddit, twitter)
      Comma-separated list of platforms to run — options: facebook, reddit, twitter. Omit to run all of them; name specific platforms to limit the run.
  - result_depth (optional): 3 (default — override if you like)
      How many pages of results to pull per platform where supported (maps to the pages param). Higher returns more leads but runs slower; defaults to a shallow first page.

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_facebook_locations` — search_facebook_locations(query={city})
     Only run if {platforms} includes facebook: resolve the metro to its numeric location_id for geo-scoped searching.
  2. Tool `search_facebook_posts` — search_facebook_posts(query="{intent_phrase}", location_id=<location_id>, sort_by=most_recent, get_sentiment=true, pages=3)
     Only run if {platforms} includes facebook: surface fresh geo-tagged public posts signaling active need and keep ones expressing clear intent.
  3. Tool `facebook_group_details` — facebook_group_details(url={group_url})
     Only run if {platforms} includes facebook and a {group_url} is provided: resolve the local community/newcomers group to its group_id.
  4. Tool `facebook_group_search` — facebook_group_search(query="{intent_phrase}", group_id=<group_id>, get_sentiment=true, pages=3)
     Only run if {platforms} includes facebook and a {group_url} is provided: mine the same intent inside the group, where high-intent residents often post first.
  5. Tool `search_reddit` — search_reddit(query="{intent_phrase} {city}", sort_by=most_recent, get_sentiment=true)
     Only run if {platforms} includes reddit: catch locals posting recommendation requests in their city subreddit — the top organic channel for 'who should I hire' asks — scoped by the city term in the query.
  6. Tool `search_twitter` — search_twitter(query="{intent_phrase} {city}", sort_by=most_recent, get_sentiment=true, pages=3)
     Only run if {platforms} includes twitter: capture fresh public posts where locals ask for or announce the need, scoped to the metro by the city term in the query.

DELIVER: A live, deduped feed of local residents in {city} signaling active intent across Facebook, Reddit, and X — each with the post link and sentiment for direct outreach

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.