mcpbeat

Multi Platform Search Searchapi

gooseworks-ai/multi-platform-search-searchapi

Multi-platform search - YouTube, Amazon, eBay, Walmart, TikTok, Instagram, and more

4k tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
1086
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/gooseworks-ai/goose-skills --skill multi-platform-search-searchapi

What comes with it

317 bytes besides the instruction
skill.meta.json

The instruction itself

24 sections, as written by the author

Setup

Read your credentials from ~/.gooseworks/credentials.json:

export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Search across YouTube, Amazon, eBay, Walmart, TikTok, Instagram, Airbnb, and ad libraries.

Capabilities

  • TripAdvisor Search: Search TripAdvisor listings
  • YouTube Comments: Get comments on a YouTube video
  • YouTube Channel: Get YouTube channel info
  • Reddit Ad Library: Search Reddit ads library
  • Meta Ad Library: Search Meta/Facebook ads library
  • YouTube Transcripts: Get video transcript/captions
  • Amazon Search: Search Amazon products
  • eBay Search: Search eBay listings
  • YouTube Video Details: Get detailed info about a YouTube video
  • YouTube Channel Videos: Get videos from a YouTube channel
  • Apple App Store Search: Search Apple App Store apps
  • Airbnb Search: Search Airbnb listings
  • TikTok Profile: Get TikTok user profile info
  • Instagram Profile: Get Instagram profile info
  • Walmart Search: Search Walmart products
  • TikTok Ads Library: Search TikTok ads library
  • LinkedIn Ad Library: Search LinkedIn ads library
  • YouTube Search: Search YouTube videos by query

Usage

Search TripAdvisor listings

Parameters:

  • engine* (string)
  • q* (string) - Search query
  • tripadvisor_domain (string) - TripAdvisor domain
  • category (string) - Category filter (all, hotels, restaurants, attractions)
  • location (string) - Location filter
  • lat (number) - Latitude for geo search
  • lon (number) - Longitude for geo search
  • page (integer) - Page number
  • num (integer) - Number of results
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"tripadvisor","q":"best%20restaurants%20NYC"}}'

YouTube Comments

Get comments on a YouTube video

Parameters:

  • engine* (string)
  • video_id* (string) - YouTube video ID
  • gl (string) - Country code
  • hl (string) - Language code
  • next_page_token (string) - Pagination token
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_comments","video_id":"dQw4w9WgXcQ"}}'

YouTube Channel

Get YouTube channel info

Parameters:

  • engine* (string)
  • channel_id* (string) - YouTube channel ID
  • gl (string) - Country code
  • hl (string) - Language code
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_channel","channel_id":"UC_x5XG1OV2P6uZZ5FSM9Ttw"}}'

Reddit Ad Library

Search Reddit ads library

Parameters:

  • engine* (string)
  • q* (string) - Search query
  • industry (string) - Industry filter
  • objective_type (string) - Campaign objective
  • budget_category (string) - Budget category
  • placements (string) - Ad placements
  • post_type (string) - Post type filter
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"reddit_ad_library","q":"software"}}'

Meta Ad Library

Search Meta/Facebook ads library

Parameters:

  • engine* (string)
  • q (string) - Search query
  • page_id (string) - Facebook page ID
  • location_id (string) - Location ID
  • country (string) - Country code
  • content_languages (string) - Content language filter
  • active_status (string) - Active status filter
  • ad_type (string) - Ad type filter
  • media_type (string) - Media type filter
  • platforms (string) - Platform filter (facebook, instagram)
  • sort_by (string) - Sort order
  • start_date (string) - Start date filter
  • end_date (string) - End date filter
  • next_page_token (string) - Pagination token
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"meta_ad_library","q":"AI%20tools"}}'

YouTube Transcripts

Get video transcript/captions

Parameters:

  • engine* (string)
  • video_id* (string) - YouTube video ID
  • lang (string) - Transcript language code
  • transcript_type (string) - Type of transcript
  • transcript_name (string) - Name of specific transcript
  • only_available (boolean) - Only return available transcripts
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_transcripts","video_id":"dQw4w9WgXcQ"}}'

Search Amazon products

Parameters:

  • engine* (string)
  • q* (string) - Search query
  • amazon_domain (string) - Amazon domain (e.g. amazon.com, amazon.co.uk)
  • language (string) - Language code
  • delivery_country (string) - Delivery country code
  • page (integer) - Page number
  • sort_by (string) - Sort order
  • price_min (number) - Minimum price filter
  • price_max (number) - Maximum price filter
  • rh (string) - Refinement filters
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"amazon_search","q":"wireless%20headphones"}}'

Search eBay listings

Parameters:

  • engine* (string)
  • q* (string) - Search query
  • ebay_domain (string) - eBay domain (e.g. ebay.com)
  • country (string) - Country code
  • delivery_country (string) - Delivery country
  • page (integer) - Page number
  • num (integer) - Number of results
  • layout (string) - Results layout
  • sort_by (string) - Sort order
  • price_min (number) - Minimum price
  • price_max (number) - Maximum price
  • condition (string) - Item condition filter
  • buying_format (string) - Buying format filter
  • category_id (string) - Category ID
  • postal_code (string) - Postal code for local
  • distance_radius (integer) - Distance radius in miles
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"ebay_search","q":"vintage%20watch"}}'

YouTube Video Details

Get detailed info about a YouTube video

Parameters:

  • engine* (string)
  • video_id* (string) - YouTube video ID
  • gl (string) - Country code
  • hl (string) - Language code
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_video","video_id":"dQw4w9WgXcQ"}}'

YouTube Channel Videos

Get videos from a YouTube channel

Parameters:

  • engine* (string)
  • channel_id* (string) - YouTube channel ID
  • gl (string) - Country code
  • hl (string) - Language code
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube_channel_videos","channel_id":"UC_x5XG1OV2P6uZZ5FSM9Ttw"}}'

Search Apple App Store apps

Parameters:

  • engine* (string)
  • term* (string) - Search term
  • country (string) - Country code (e.g. us, gb)
  • lang (string) - Language code
  • page (integer) - Page number
  • num (integer) - Number of results
  • device (string) - Device filter (iphone, ipad)
  • property (string) - Property filter
  • include_explicit (boolean) - Include explicit content
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"apple_app_store","term":"productivity"}}'

Search Airbnb listings

Parameters:

  • engine* (string)
  • q* (string) - Location query
  • airbnb_domain (string) - Airbnb domain
  • currency (string) - Currency code (e.g. USD, EUR)
  • check_in_date (string) - Check-in date (YYYY-MM-DD)
  • check_out_date (string) - Check-out date (YYYY-MM-DD)
  • time_period (string) - Flexible time period
  • adults (integer) - Number of adults
  • children (integer) - Number of children
  • infants (integer) - Number of infants
  • pets (integer) - Number of pets
  • price_min (number) - Minimum price
  • price_max (number) - Maximum price
  • bedrooms (integer) - Number of bedrooms
  • beds (integer) - Number of beds
  • bathrooms (integer) - Number of bathrooms
  • property_types (string) - Property type filter
  • type_of_place (string) - Entire place/private room/shared
  • amenities (string) - Amenities filter
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"airbnb","q":"Paris"}}'

TikTok Profile

Get TikTok user profile info

Parameters:

  • engine* (string)
  • username* (string) - TikTok username
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"tiktok_profile","username":"openai"}}'

Instagram Profile

Get Instagram profile info

Parameters:

  • engine* (string)
  • username* (string) - Instagram username
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"instagram_profile","username":"openai"}}'

Search Walmart products

Parameters:

  • engine* (string)
  • q* (string) - Search query
  • page (integer) - Page number
  • sort_by (string) - Sort order
  • price_min (number) - Minimum price
  • price_max (number) - Maximum price
  • category_id (string) - Category ID
  • store_id (string) - Store ID for local inventory
  • filters (string) - Additional filters
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"walmart_search","q":"laptop"}}'

TikTok Ads Library

Search TikTok ads library

Parameters:

  • engine* (string)
  • q (string) - Search query
  • advertiser_id (string) - Advertiser ID
  • country (string) - Country code
  • time_period (string) - Time period filter
  • sort_by (string) - Sort order
  • next_page_token (string) - Pagination token
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"tiktok_ads_library","q":"AI"}}'

LinkedIn Ad Library

Search LinkedIn ads library

Parameters:

  • engine* (string)
  • q (string) - Search query
  • advertiser (string) - Advertiser name
  • country (string) - Country code
  • time_period (string) - Time period filter
  • next_page_token (string) - Pagination token
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"linkedin_ad_library","q":"hiring"}}'

Search YouTube videos by query

Parameters:

  • engine* (string)
  • q* (string) - Search query
  • sp (string) - Search filter parameter
  • gl (string) - Country code (e.g. us, uk, de)
  • hl (string) - Language code (e.g. en, de, fr)
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search","query":{"engine":"youtube","q":"AI%20agents"}}'

Use Cases

  • Product Research: Compare products across Amazon, eBay, Walmart
  • Video Intelligence: Search YouTube videos, channels, and transcripts
  • Ad Research: Monitor ads on Meta, TikTok, Reddit, LinkedIn
  • Social Media: Get TikTok and Instagram profiles
  • Travel: Search Airbnb listings and TripAdvisor reviews

Discover More

For full endpoint details and parameters:

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/search \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"searchapi API endpoints"}' List all endpoints
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/details \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"searchapi","path":"/api/v1/search"}'   # Get endpoint details

How to use it

Copy the folder

Take gooseworks-ai/multi-platform-search-searchapi from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference npx. Without those the skill loads but fails at the first command.