LurkAPI as a remote goose extension: public social media and ad library data

[mesmerlord]

I built LurkAPI, a social media data API, and its endpoints are also a remote MCP server. As a goose extension it reads public data from TikTok, Instagram, YouTube, Reddit, X, LinkedIn and the Meta, Google, TikTok and LinkedIn ad libraries. Here's the setup.

Add it

goose configure → Add Extension → Remote Extension (Streamable HTTP), with the URL https://api.lurkapi.com/mcp. The first time goose uses it, it opens the browser to sign in (Google or an email code). New accounts get 100 free credits, no card.

For one session:

goose session --with-streamable-http-extension "https://api.lurkapi.com/mcp"

Or in ~/.config/goose/config.yaml, with an API key from the dashboard instead of OAuth:

extensions:
  lurkapi:
    type: streamable_http
    name: lurkapi
    enabled: true
    uri: "https://api.lurkapi.com/mcp"
    headers:
      x-api-key: "lk_live_..."
    timeout: 300
    available_tools: [facebook_search_companies, facebook_company_ads, tiktok_profile, youtube_transcript]

There's one tool per endpoint (89); available_tools keeps the ones goose loads to what you need. Without it, all of them load.

Try it

What ads is Nike running on Facebook and Instagram right now? Group them by what they're selling.

goose finds the advertiser with facebook_search_companies, then calls facebook_company_ads with its pageId and status: active. One ad from the answer, trimmed:

{
  "page_name": "Nike",
  "searchResultsCount": 3198,
  "results": [
    {
      "ad_archive_id": "1702938977100376",
      "is_active": true,
      "publisher_platform": ["FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK", "MESSENGER"],
      "snapshot": {
        "body": "Bring sports more fully into your day with the Nike App.",
        "link_url": "http://itunes.apple.com/app/id1095459556",
        "cta_text": "Install now"
      }
    }
  ]
}

Results come in pages with a cursor, so goose can keep reading. The same works for a TikTok profile (tiktok_profile) or a YouTube video's transcript (youtube_transcript).

Most calls cost 1 credit; packs start at $9 for 10,000. It reads public data only and can't post or message anyone. Docs: https://lurkapi.com/docs

Feedback welcome, especially on which tools goose picks well and which it doesn't.