OpenWeb Ninja MCP
About
Official MCP server for OpenWeb Ninja: 40+ real-time web data and SERP APIs (Google Maps, Amazon, jobs, Zillow, Trustpilot, web search, news, finance) exposed as MCP tools.
Explore
- Provides real-time access to 40+ web data and SERP APIs
- Supports Google Maps, Amazon, jobs, Zillow, Trustpilot, search, news, finance
- Single server for diverse data sources
- Compatible with any MCP-compatible agent
- API key authentication
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OpenWeb Ninja MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Obtain an API key from openwebninja.com, then configure your MCP-compatible client to point to this server. Full documentation is available at https://www.openwebninja.com.
ai_overviews
Fetch Google's AI Overview answer block for a search query. Operations (set "operation" to one of these; put its parameters in "args"): - ai_overviews (required: q): AI Overviews
chatgpt
Relay a chat prompt to ChatGPT (OpenAI) and get the model's response. Operations (set "operation" to one of these; put its parameters in "args"): - chat (required: message): Chat
copilot
Relay a prompt to Microsoft Copilot and get the response. Operations (set "operation" to one of these; put its parameters in "args"): - copilot (no required params): Copilot
driving_directions
Turn-by-turn driving directions and route details between origin and destination. Operations (set "operation" to one of these; put its parameters in "args"): - get_directions (required: origin, destination): Get Directions
email_search
Find email addresses for a query within a given email domain (up to 5,000 results). Operations (set "operation" to one of these; put its parameters in "args"): - search_emails (required: query, email_domain): Search Emails When to use: Use to discover emails by query + domain. To scrape contacts from a known website use website_contacts_scraper.
ev_charge_finder
Find EV charging stations by location name or by coordinates, with connector and availability details. Operations (set "operation" to one of these; put its parameters in "args"): - search_by_location (required: near): Search by Location - search_by_coordinates_point (required: lat, lng): Search by Coordinates Point
gemini
Relay a chat prompt to Google Gemini and get the model's response. Operations (set "operation" to one of these; put its parameters in "args"): - chat (required: message): Chat
google_ai_mode
Fetch Google's AI Mode conversational answer for a query. Operations (set "operation" to one of these; put its parameters in "args"): - ai_mode (required: prompt): AI Mode - ai_mode_post (required: prompt): AI Mode (POST)
job_salary_data
Estimated salary ranges for a job title and location, and company-specific job salaries. Operations (set "operation" to one of these; put its parameters in "args"): - job_salary (required: job_title, location): Job Salary - company_job_salary (required: company, job_title): Company Job Salary
jsearch
Job search aggregated from Google for Jobs (LinkedIn, Indeed, Glassdoor and more): search jobs, job details, and estimated salaries. Operations (set "operation" to one of these; put its parameters in "args"): - search_v2 (required: query): Job Search V2 - search (required: query): Job Search - job_details (required: job_id): Job Details - estimated_salary (required: job_title, location): Job Salary - company_job_salary (required: company, job_title): Company Job Salary When to use: Use to find job postings. For salary data only use job_salary_data; for company reviews/ratings use realtime_glassdoor_data.
local_business_data
Google Maps business and place data: search businesses, search by area/coordinates/nearby, plus full details, reviews, photos, posts, autocomplete and reverse geocoding. Includes contact info where available. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search - search_post (required: queries): Bulk Search - search_in_area (required: query, lat, lng, zoom): Search In Area - area_search_by_bounding_box (required: query, bottom_left, top_right): Area Search (Bounding Box) - area_search_by_radius (required: query, lat, lng, radius): Area Search (Radius) - search_nearby (required: query, lat, lng): Search Nearby - business_details (required: business_id): Business Details - business_details_plus (required: business_id): Business Details Plus - business_reviews_v2 (required: business_id): Business Reviews - review_details (required: business_id, review_author_id): Business Review Details - business_photos (required: business_id): Business Photos - photo_details (required: business_id, photo_id): Business Photo Details - business_posts (required: business_id): Buisness Posts - reverse_geocoding (required: lat, lng): Reverse Geocoding - autocomplete (required: query): Autocomplete When to use: The primary tool for local businesses and places (Google Maps source). For Yelp use yelp_business_data; for Trustpilot reviews use trustpilot_company_and_reviews.
local_rank_tracker
Track a business's local search ranking across a geographic grid of coordinates (local SEO rank grid). Operations (set "operation" to one of these; put its parameters in "args"): - places (required: query): Search Business Locations - search (required: query, lat, lng): Keyword Search at Coordinate Point - calculate_grid_coordinates (required: lat, lng, grid_size, radius): Calculate Grid Coordinate Points - ranking_at_coordinate (required: place_id, query, lat, lng): Ranking at Coordinate Point - grid (required: place_id, query, lat, lng, grid_size, radius): Full Grid Search
play_store_apps
Google Play Store data: app search, app details, reviews, categories, developer apps and more. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: q): Search - app_reviews (required: app_id): App Reviews - app_details (required: app_id): App Details - categories (no required params): App Categories - top_grossing_apps (no required params): Top Grossing Apps - top_paid_apps (no required params): Top Paid Apps - top_free_apps (no required params): Top Free Apps - top_free_games (no required params): Top Free Games - top_grossing_games (no required params): Top Grossing Games - top_paid_games (no required params): Top Paid Games
real_time_ebay_data
eBay product search, products by category, product details and seller feedback across eBay domains. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Product Search - products_by_category (required: category_id): Products by Category - product_details (required: product_id): Product Details - seller_feedback (required: seller_id): Seller Feedback
real_time_news_search
Flat news article search across many outlets for a keyword query. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search When to use: Use for a simple article keyword search. For Google News structure (topics, headlines) use realtime_news_data.
real_time_redfin_data
Redfin real estate data: search listings by location/coordinates/polygon, property details and market trends. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: location): Search - search_coordinates (required: ne_lat, ne_lng, sw_lat, sw_lng): Search by Coordinates - search_polygon (required: polygon): Search by Polygon - property_details (no required params): Property Details - market_trends (required: location): Market Trends
real_time_video_search
Search videos across YouTube, Vimeo, TikTok and the web for a query. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search When to use: Use for full-length videos. For short-form clips use realtime_shorts_search.
real_time_walmart_data
Walmart product search, products by category, product details, offers and reviews. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Product Search - products_by_category (required: category_id): Products By Category - product_details (required: product_id): Product Details - product_offers (required: product_id): Product Offers - product_reviews (required: product_id): Product Reviews
real_time_wayfair_data
Wayfair product search, product details and reviews (furniture and home goods). Operations (set "operation" to one of these; put its parameters in "args"): - search (no required params): Search - product_details (required: sku): Product Details - product_reviews (required: sku): Product Reviews
realtime_amazon_data
Amazon product data: search, products by category, product details/offers/reviews, best sellers, deals, seller and influencer data, ASIN-to-GTIN and more. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Product Search - products_by_category (required: category_id): Product by Category - product_details (required: asin): Product Details - product_reviews (required: asin, cookie): Product Reviews - product_review_details (required: review_id, cookie): Product Review Details - top_product_reviews (required: asin): Top Product Reviews - product_offers (required: asin): Product Offers - seller_profile (required: seller_id): Seller Profile - seller_reviews (required: seller_id): Seller Reviews - seller_products (required: seller_id): Seller Products - best_sellers (required: category): Best Sellers - deals_v2 (no required params): Deals - deal_products (required: deal_id): Deal Products - promo_code_details (required: promo_code): Promo Code Details - influencer_profile (required: influencer_name): Influencer Profile - influencer_posts (required: influencer_name): Influencer Posts - influencer_post_products (required: influencer_name, post_id): Influencer Post Products - asin_to_gtin (required: asin): ASIN to GTIN - gtin_to_asin (required: product_identifier): GTIN to ASIN - product_category_list (no required params): Product Category List - scrape_by_url (required: url): Scrape By URL When to use: Use for Amazon specifically. For multi-retailer Google Shopping use realtime_product_search; for Walmart/Costco/Wayfair/eBay use their dedicated tools.
realtime_books_data
Book search with metadata across major book sources. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search Books
realtime_costco_data
Costco product search and product details. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search - product_details (required: product_id): Product Details
realtime_events_data
Search local and online events, with full event details (concerts, conferences, festivals and more). Operations (set "operation" to one of these; put its parameters in "args"): - search_events (required: query): Search Events - event_details (required: event_id): Event Details
realtime_finance_data
Real-time finance data: stock quotes/overviews, market trends, time series, company financials (income, balance sheet, cash flow), currency exchange and crypto. Operations (set "operation" to one of these; put its parameters in "args"): - search (no required params): Search - market_trends (no required params): Market Trends - stock_quote (no required params): Stock Quote - stock_time_series (no required params): Stock Time Series - stock_news (no required params): Stock News - stock_overview (no required params): Stock / Company Overview - company_income_statement (no required params): Company Income Statement - company_balance_sheet (no required params): Company Balance Sheet - company_cash_flow (no required params): Company Cash Flow - currency_exchange_rate (no required params): Currency Exchange Rate - currency_time_series (no required params): Currency Time Series - currency_news (no required params): Currency News - stock_quote_yahoo_finance (no required params): Stock Quote (Yahu Finance) - stock_time_series_yahoo_finance (no required params): Stock Time Series (Yahu Finance)
realtime_forums_search
Search discussion forums and community threads (Reddit and similar) for a query. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search Forums
realtime_glassdoor_data
Glassdoor company data: company search, overview, reviews, salaries, interviews and jobs. Operations (set "operation" to one of these; put its parameters in "args"): - company_search (required: query): Company Search - company_overview (required: company_id): Company Overview - company_reviews (required: company_id): Company Reviews - company_jobs (required: company_id): Company Jobs - company_salaries (required: company_id, job_title): Company Salaries - company_salaries_v2 (required: company_id): Company Salaries v2 - company_interviews (required: company_id): Company Interviews - job_search (required: query, location): Job Search - salary_estimation (required: job_title, location): Salary Estimate
realtime_homedepot_data
Fast and Reliable Product Searches, Product List by Category, Extensive Products Details, Product Reviews, and More on Home Depot in Real-Time. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search - products_by_category (required: category_id): Products By Category - product_details (no required params): Product Details - item_lookup (required: search): Item Lookup - product_reviews (required: item_id): Product Reviews
realtime_image_search
Google Images search with filters (size, color, type, license) and full image metadata. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search Images When to use: Use to find images by keyword. To search BY an image (find where it appears) use reverse_image_search or realtime_lens_data.
realtime_lens_data
Google Lens on an image URL: visual matches, exact matches, object detection and OCR text extraction. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: url): Image Search - visual_matches (required: url): Visual Matches - exact_matches (required: url): Exact Matches - object_detection (required: url): Object Detection - ocr (required: url): Image to Text (OCR) When to use: Use for deep visual analysis of an image (objects, text, exact product matches). For simple reverse lookup use reverse_image_search.
realtime_news_data
Google News data: search news, top and topic headlines, by-section and local headlines, and full-story coverage. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search - top_headlines (no required params): Top Headlines - topic_headlines (required: topic): Topic Headlines - topic_news_by_section (required: topic): Topic News By Section - local_headlines (required: query): Local Headlines (Geo) - full_story_coverage (required: story): Full Story Coverage - language_list (required: country): Language List When to use: Use for structured Google News (headlines, topics, coverage). For a flat news search across outlets use real_time_news_search; for general web results use realtime_web_search.
realtime_product_search/v2
Complete reference documentation for the OpenWeb Ninja Real-Time Product Search API. Includes code examples, data samples, and usage guides for searching Google Shopping for products, offers, and reviews across major retailers. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: q): Product Search - product_details (required: product_id): Product Details - product_offers (required: product_id): Product Offers - product_price_history (required: product_id): Product Price History - product_reviews (required: product_id): Product Reviews - deals (required: q): Deals - store_reviews (required: store_domain): Store Reviews
realtime_shorts_search
Search short-form videos (YouTube Shorts and similar) for a query. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: query): Search Shorts
realtime_web_search
Real-time Google web search (SERP). Organic results, knowledge panels, AI Overviews and AI Mode answers for any query. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: q): Search - search_full (required: q): Search Full - search_light (required: q): Light Search - search_light_post (required: queries): Light Search (Bulk) - ai_mode (required: prompt): AI Mode - ai_mode_post (required: prompt): AI Mode (POST) - people_also_ask (required: q): People Also Ask When to use: Use for general web/Google searches. For news specifically use realtime_news_data; for autocomplete suggestions use web_search_autocomplete.
realtime_zillow_data
Zillow real estate data: search listings by location/coordinates/polygon, property details, and market trends. Operations (set "operation" to one of these; put its parameters in "args"): - search (required: location): Search - search_coordinates (required: long, lat): Search by Coordinates - search_polygon (required: polygon): Search by Polygon - property_details (no required params): Property Details - property_details_address (required: address): Property by Address - zestimate (required: zpid): Property Zestimate - agent_search (required: location): Agent Search - agent_properties_for_sale (required: encodedZuid): Agent Active Listings - agent_properties_sold (required: encodedZuid): Agent Sold Listings - agent_properties_for_rent (required: encodedZuid): Agent Rental Listings When to use: Use for Zillow. For Redfin listings use real_time_redfin_data.
reverse_image_search
Reverse image search: give an image URL, find visually matching and related images across the web. Operations (set "operation" to one of these; put its parameters in "args"): - reverse_image_search (required: url): Reverse Image Search
social_links_search
Find social media profile links (Instagram, LinkedIn, X, Facebook, TikTok, YouTube and more) for a query, domain or brand. Operations (set "operation" to one of these; put its parameters in "args"): - search_social_links (required: query): Search Social Links
trustpilot_company_and_reviews
Trustpilot company search, company details, reviews, and category company listings. Operations (set "operation" to one of these; put its parameters in "args"): - company_search (required: query): Company Search - company_details (required: company_domain): Company Details - company_reviews (required: company_domain): Company Reviews - category_company_list (required: category_id): Companies by Category - category_recently_reviewed_companies (required: category_id): Recently Reviewed Companies in Category - category_newest_companies (required: category_id): Newest Companies in Category - category_search (required: query): Category Search - category_details (required: category_id): Category Details - consumer_details (required: consumer_id): Consumer Details - consumer_reviews (required: consumer_id): Consumer Reviews
waze
Waze data: traffic alerts and jams, driving directions, venue lookup, and place autocomplete. Operations (set "operation" to one of these; put its parameters in "args"): - alerts_and_jams (required: bottom_left, top_right): Alerts and Jams - driving_directions (required: source_coordinates, destination_coordinates): Driving Directions - venues (required: bottom_left, top_right): Venues - autocomplete (required: q, coordinates): Autocomplete
web_search_autocomplete
Google search autocomplete / query suggestions for a partial query. Operations (set "operation" to one of these; put its parameters in "args"): - autocomplete (required: query): Autocomplete
web_unblocker
Fetch the raw HTML/content of any URL through OWN's anti-bot proxy network, with optional JavaScript rendering. A general-purpose unblocker for sites without a dedicated tool. Operations (set "operation" to one of these; put its parameters in "args"): - request (required: url): Request When to use: Use only when no dedicated API covers the target site. Prefer the structured tools (Amazon, Zillow, etc.) when one exists.
website_contacts_scraper
Extract emails, phone numbers and social links from a website/domain; also find a website URL by keyword. Operations (set "operation" to one of these; put its parameters in "args"): - scrape_contacts (required: query): Scrape Contacts from Website When to use: Use to scrape contacts from a specific domain. To search the web for emails by person/company use email_search.
yelp_business_data
Yelp business search, business details, and Yelp reviews. Operations (set "operation" to one of these; put its parameters in "args"): - business_search (required: query, location): Business Search - business_details (required: business_id): Business Details - business_reviews (required: business_id): Business Reviews When to use: Use for Yelp specifically. For Google Maps businesses use local_business_data.
subscribe
Subscribe the current OpenWeb Ninja API key to an API's free (BASIC) tier so that API's tool can be used. Call this when another tool returns a subscription/entitlement error: HTTP 401/403, or a 429 "Too Many Requests" when you have not subscribed to that API yet. Pass api_id = the name of the tool you want to use (e.g. "realtime_image_search"). Free tier only: it never incurs charges and will not alter an existing paid subscription. After it succeeds, wait a few seconds for it to take effect, then retry the original tool.
- ai_overviews: Fetch Google's AI Overview answer block for a search query.
Operations (set "operation" to one of these; put its parameters in "args"):
- ai_overviews (required: q): AI Overviews
- chatgpt: Relay a chat prompt to ChatGPT (OpenAI) and get the model's response.
Operations (set "operation" to one of these; put its parameters in "args"):
- chat (required: message): Chat
- copilot: Relay a prompt to Microsoft Copilot and get the response.
Operations (set "operation" to one of these; put its parameters in "args"):
- copilot (no required params): Copilot
- driving_directions: Turn-by-turn driving directions and route details between origin and destination.
Operations (set "operation" to one of these; put its parameters in "args"):
- get_directions (required: origin, destination): Get Directions
- email_search: Find email addresses for a query within a given email domain (up to 5,000 results).
Operations (set "operation" to one of these; put its parameters in "args"):
- search_emails (required: query, email_domain): Search Emails
When to use: Use to discover emails by query + domain. To scrape contacts from a known website use website_contacts_scraper.
- ev_charge_finder: Find EV charging stations by location name or by coordinates, with connector and availability details.
Operations (set "operation" to one of these; put its parameters in "args"):
- search_by_location (required: near): Search by Location
- search_by_coordinates_point (required: lat, lng): Search by Coordinates Point
- gemini: Relay a chat prompt to Google Gemini and get the model's response.
Operations (set "operation" to one of these; put its parameters in "args"):
- chat (required: message): Chat
- google_ai_mode: Fetch Google's AI Mode conversational answer for a query.
Operations (set "operation" to one of these; put its parameters in "args"):
- ai_mode (required: prompt): AI Mode
- ai_mode_post (required: prompt): AI Mode (POST)
- job_salary_data: Estimated salary ranges for a job title and location, and company-specific job salaries.
Operations (set "operation" to one of these; put its parameters in "args"):
- job_salary (required: job_title, location): Job Salary
- company_job_salary (required: company, job_title): Company Job Salary
- jsearch: Job search aggregated from Google for Jobs (LinkedIn, Indeed, Glassdoor and more): search jobs, job details, and estimated salaries.
Operations (set "operation" to one of these; put its parameters in "args"):
- search_v2 (required: query): Job Search V2
- search (required: query): Job Search
- job_details (required: job_id): Job Details
- estimated_salary (required: job_title, location): Job Salary
- company_job_salary (required: company, job_title): Company Job Salary
When to use: Use to find job postings. For salary data only use job_salary_data; for company reviews/ratings use realtime_glassdoor_data.
- local_business_data: Google Maps business and place data: search businesses, search by area/coordinates/nearby, plus full details, reviews, photos, posts, autocomplete and reverse geocoding. Includes contact info where available.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search
- search_post (required: queries): Bulk Search
- search_in_area (required: query, lat, lng, zoom): Search In Area
- area_search_by_bounding_box (required: query, bottom_left, top_right): Area Search (Bounding Box)
- area_search_by_radius (required: query, lat, lng, radius): Area Search (Radius)
- search_nearby (required: query, lat, lng): Search Nearby
- business_details (required: business_id): Business Details
- business_details_plus (required: business_id): Business Details Plus
- business_reviews_v2 (required: business_id): Business Reviews
- review_details (required: business_id, review_author_id): Business Review Details
- business_photos (required: business_id): Business Photos
- photo_details (required: business_id, photo_id): Business Photo Details
- business_posts (required: business_id): Buisness Posts
- reverse_geocoding (required: lat, lng): Reverse Geocoding
- autocomplete (required: query): Autocomplete
When to use: The primary tool for local businesses and places (Google Maps source). For Yelp use yelp_business_data; for Trustpilot reviews use trustpilot_company_and_reviews.
- local_rank_tracker: Track a business's local search ranking across a geographic grid of coordinates (local SEO rank grid).
Operations (set "operation" to one of these; put its parameters in "args"):
- places (required: query): Search Business Locations
- search (required: query, lat, lng): Keyword Search at Coordinate Point
- calculate_grid_coordinates (required: lat, lng, grid_size, radius): Calculate Grid Coordinate Points
- ranking_at_coordinate (required: place_id, query, lat, lng): Ranking at Coordinate Point
- grid (required: place_id, query, lat, lng, grid_size, radius): Full Grid Search
- play_store_apps: Google Play Store data: app search, app details, reviews, categories, developer apps and more.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: q): Search
- app_reviews (required: app_id): App Reviews
- app_details (required: app_id): App Details
- categories (no required params): App Categories
- top_grossing_apps (no required params): Top Grossing Apps
- top_paid_apps (no required params): Top Paid Apps
- top_free_apps (no required params): Top Free Apps
- top_free_games (no required params): Top Free Games
- top_grossing_games (no required params): Top Grossing Games
- top_paid_games (no required params): Top Paid Games
- real_time_ebay_data: eBay product search, products by category, product details and seller feedback across eBay domains.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Product Search
- products_by_category (required: category_id): Products by Category
- product_details (required: product_id): Product Details
- seller_feedback (required: seller_id): Seller Feedback
- real_time_news_search: Flat news article search across many outlets for a keyword query.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search
When to use: Use for a simple article keyword search. For Google News structure (topics, headlines) use realtime_news_data.
- real_time_redfin_data: Redfin real estate data: search listings by location/coordinates/polygon, property details and market trends.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: location): Search
- search_coordinates (required: ne_lat, ne_lng, sw_lat, sw_lng): Search by Coordinates
- search_polygon (required: polygon): Search by Polygon
- property_details (no required params): Property Details
- market_trends (required: location): Market Trends
- real_time_video_search: Search videos across YouTube, Vimeo, TikTok and the web for a query.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search
When to use: Use for full-length videos. For short-form clips use realtime_shorts_search.
- real_time_walmart_data: Walmart product search, products by category, product details, offers and reviews.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Product Search
- products_by_category (required: category_id): Products By Category
- product_details (required: product_id): Product Details
- product_offers (required: product_id): Product Offers
- product_reviews (required: product_id): Product Reviews
- real_time_wayfair_data: Wayfair product search, product details and reviews (furniture and home goods).
Operations (set "operation" to one of these; put its parameters in "args"):
- search (no required params): Search
- product_details (required: sku): Product Details
- product_reviews (required: sku): Product Reviews
- realtime_amazon_data: Amazon product data: search, products by category, product details/offers/reviews, best sellers, deals, seller and influencer data, ASIN-to-GTIN and more.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Product Search
- products_by_category (required: category_id): Product by Category
- product_details (required: asin): Product Details
- product_reviews (required: asin, cookie): Product Reviews
- product_review_details (required: review_id, cookie): Product Review Details
- top_product_reviews (required: asin): Top Product Reviews
- product_offers (required: asin): Product Offers
- seller_profile (required: seller_id): Seller Profile
- seller_reviews (required: seller_id): Seller Reviews
- seller_products (required: seller_id): Seller Products
- best_sellers (required: category): Best Sellers
- deals_v2 (no required params): Deals
- deal_products (required: deal_id): Deal Products
- promo_code_details (required: promo_code): Promo Code Details
- influencer_profile (required: influencer_name): Influencer Profile
- influencer_posts (required: influencer_name): Influencer Posts
- influencer_post_products (required: influencer_name, post_id): Influencer Post Products
- asin_to_gtin (required: asin): ASIN to GTIN
- gtin_to_asin (required: product_identifier): GTIN to ASIN
- product_category_list (no required params): Product Category List
- scrape_by_url (required: url): Scrape By URL
When to use: Use for Amazon specifically. For multi-retailer Google Shopping use realtime_product_search; for Walmart/Costco/Wayfair/eBay use their dedicated tools.
- realtime_books_data: Book search with metadata across major book sources.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search Books
- realtime_costco_data: Costco product search and product details.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search
- product_details (required: product_id): Product Details
- realtime_events_data: Search local and online events, with full event details (concerts, conferences, festivals and more).
Operations (set "operation" to one of these; put its parameters in "args"):
- search_events (required: query): Search Events
- event_details (required: event_id): Event Details
- realtime_finance_data: Real-time finance data: stock quotes/overviews, market trends, time series, company financials (income, balance sheet, cash flow), currency exchange and crypto.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (no required params): Search
- market_trends (no required params): Market Trends
- stock_quote (no required params): Stock Quote
- stock_time_series (no required params): Stock Time Series
- stock_news (no required params): Stock News
- stock_overview (no required params): Stock / Company Overview
- company_income_statement (no required params): Company Income Statement
- company_balance_sheet (no required params): Company Balance Sheet
- company_cash_flow (no required params): Company Cash Flow
- currency_exchange_rate (no required params): Currency Exchange Rate
- currency_time_series (no required params): Currency Time Series
- currency_news (no required params): Currency News
- stock_quote_yahoo_finance (no required params): Stock Quote (Yahu Finance)
- stock_time_series_yahoo_finance (no required params): Stock Time Series (Yahu Finance)
- realtime_forums_search: Search discussion forums and community threads (Reddit and similar) for a query.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search Forums
- realtime_glassdoor_data: Glassdoor company data: company search, overview, reviews, salaries, interviews and jobs.
Operations (set "operation" to one of these; put its parameters in "args"):
- company_search (required: query): Company Search
- company_overview (required: company_id): Company Overview
- company_reviews (required: company_id): Company Reviews
- company_jobs (required: company_id): Company Jobs
- company_salaries (required: company_id, job_title): Company Salaries
- company_salaries_v2 (required: company_id): Company Salaries v2
- company_interviews (required: company_id): Company Interviews
- job_search (required: query, location): Job Search
- salary_estimation (required: job_title, location): Salary Estimate
- realtime_homedepot_data: Fast and Reliable Product Searches, Product List by Category, Extensive Products Details, Product Reviews, and More on Home Depot in Real-Time.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search
- products_by_category (required: category_id): Products By Category
- product_details (no required params): Product Details
- item_lookup (required: search): Item Lookup
- product_reviews (required: item_id): Product Reviews
- realtime_image_search: Google Images search with filters (size, color, type, license) and full image metadata.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search Images
When to use: Use to find images by keyword. To search BY an image (find where it appears) use reverse_image_search or realtime_lens_data.
- realtime_lens_data: Google Lens on an image URL: visual matches, exact matches, object detection and OCR text extraction.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: url): Image Search
- visual_matches (required: url): Visual Matches
- exact_matches (required: url): Exact Matches
- object_detection (required: url): Object Detection
- ocr (required: url): Image to Text (OCR)
When to use: Use for deep visual analysis of an image (objects, text, exact product matches). For simple reverse lookup use reverse_image_search.
- realtime_news_data: Google News data: search news, top and topic headlines, by-section and local headlines, and full-story coverage.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search
- top_headlines (no required params): Top Headlines
- topic_headlines (required: topic): Topic Headlines
- topic_news_by_section (required: topic): Topic News By Section
- local_headlines (required: query): Local Headlines (Geo)
- full_story_coverage (required: story): Full Story Coverage
- language_list (required: country): Language List
When to use: Use for structured Google News (headlines, topics, coverage). For a flat news search across outlets use real_time_news_search; for general web results use realtime_web_search.
- realtime_product_search/v2: Complete reference documentation for the OpenWeb Ninja Real-Time Product Search API. Includes code examples, data samples, and usage guides for searching Google Shopping for products, offers, and reviews across major retailers.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: q): Product Search
- product_details (required: product_id): Product Details
- product_offers (required: product_id): Product Offers
- product_price_history (required: product_id): Product Price History
- product_reviews (required: product_id): Product Reviews
- deals (required: q): Deals
- store_reviews (required: store_domain): Store Reviews
- realtime_shorts_search: Search short-form videos (YouTube Shorts and similar) for a query.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: query): Search Shorts
- realtime_web_search: Real-time Google web search (SERP). Organic results, knowledge panels, AI Overviews and AI Mode answers for any query.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: q): Search
- search_full (required: q): Search Full
- search_light (required: q): Light Search
- search_light_post (required: queries): Light Search (Bulk)
- ai_mode (required: prompt): AI Mode
- ai_mode_post (required: prompt): AI Mode (POST)
- people_also_ask (required: q): People Also Ask
When to use: Use for general web/Google searches. For news specifically use realtime_news_data; for autocomplete suggestions use web_search_autocomplete.
- realtime_zillow_data: Zillow real estate data: search listings by location/coordinates/polygon, property details, and market trends.
Operations (set "operation" to one of these; put its parameters in "args"):
- search (required: location): Search
- search_coordinates (required: long, lat): Search by Coordinates
- search_polygon (required: polygon): Search by Polygon
- property_details (no required params): Property Details
- property_details_address (required: address): Property by Address
- zestimate (required: zpid): Property Zestimate
- agent_search (required: location): Agent Search
- agent_properties_for_sale (required: encodedZuid): Agent Active Listings
- agent_properties_sold (required: encodedZuid): Agent Sold Listings
- agent_properties_for_rent (required: encodedZuid): Agent Rental Listings
When to use: Use for Zillow. For Redfin listings use real_time_redfin_data.
- reverse_image_search: Reverse image search: give an image URL, find visually matching and related images across the web.
Operations (set "operation" to one of these; put its parameters in "args"):
- reverse_image_search (required: url): Reverse Image Search
- social_links_search: Find social media profile links (Instagram, LinkedIn, X, Facebook, TikTok, YouTube and more) for a query, domain or brand.
Operations (set "operation" to one of these; put its parameters in "args"):
- search_social_links (required: query): Search Social Links
- trustpilot_company_and_reviews: Trustpilot company search, company details, reviews, and category company listings.
Operations (set "operation" to one of these; put its parameters in "args"):
- company_search (required: query): Company Search
- company_details (required: company_domain): Company Details
- company_reviews (required: company_domain): Company Reviews
- category_company_list (required: category_id): Companies by Category
- category_recently_reviewed_companies (required: category_id): Recently Reviewed Companies in Category
- category_newest_companies (required: category_id): Newest Companies in Category
- category_search (required: query): Category Search
- category_details (required: category_id): Category Details
- consumer_details (required: consumer_id): Consumer Details
- consumer_reviews (required: consumer_id): Consumer Reviews
- waze: Waze data: traffic alerts and jams, driving directions, venue lookup, and place autocomplete.
Operations (set "operation" to one of these; put its parameters in "args"):
- alerts_and_jams (required: bottom_left, top_right): Alerts and Jams
- driving_directions (required: source_coordinates, destination_coordinates): Driving Directions
- venues (required: bottom_left, top_right): Venues
- autocomplete (required: q, coordinates): Autocomplete
- web_search_autocomplete: Google search autocomplete / query suggestions for a partial query.
Operations (set "operation" to one of these; put its parameters in "args"):
- autocomplete (required: query): Autocomplete
- web_unblocker: Fetch the raw HTML/content of any URL through OWN's anti-bot proxy network, with optional JavaScript rendering. A general-purpose unblocker for sites without a dedicated tool.
Operations (set "operation" to one of these; put its parameters in "args"):
- request (required: url): Request
When to use: Use only when no dedicated API covers the target site. Prefer the structured tools (Amazon, Zillow, etc.) when one exists.
- website_contacts_scraper: Extract emails, phone numbers and social links from a website/domain; also find a website URL by keyword.
Operations (set "operation" to one of these; put its parameters in "args"):
- scrape_contacts (required: query): Scrape Contacts from Website
When to use: Use to scrape contacts from a specific domain. To search the web for emails by person/company use email_search.
- yelp_business_data: Yelp business search, business details, and Yelp reviews.
Operations (set "operation" to one of these; put its parameters in "args"):
- business_search (required: query, location): Business Search
- business_details (required: business_id): Business Details
- business_reviews (required: business_id): Business Reviews
When to use: Use for Yelp specifically. For Google Maps businesses use local_business_data.
- subscribe: Subscribe the current OpenWeb Ninja API key to an API's free (BASIC) tier so that API's tool can be used. Call this when another tool returns a subscription/entitlement error: HTTP 401/403, or a 429 "Too Many Requests" when you have not subscribed to that API yet. Pass api_id = the name of the tool you want to use (e.g. "realtime_image_search"). Free tier only: it never incurs charges and will not alter an existing paid subscription. After it succeeds, wait a few seconds for it to take effect, then retry the original tool.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"openweb ninja mcp": {
"openwebninja": {
"command": "npx",
"args": [
"-y",
"@openwebninja/mcp-server"
],
"env": {
"OPENWEBNINJA_API_KEY": "<your-openwebninja-api-key>"
}
}
}
}
}
McpServers
{
"openwebninja": {
"command": "npx",
"args": [
"-y",
"@openwebninja/mcp-server"
],
"env": {
"OPENWEBNINJA_API_KEY": "<your-openwebninja-api-key>"
}
}
}
Official OpenWeb Ninja MCP server connecting any AI agent to 40+ web data APIs for web search, e-commerce, local business, jobs, real estate, and finance data.
OfficialModel Context Protocolserver forOpenWeb NinjaAPIs. Gives any MCP-compatible AI agent (Claude, Cursor, Cline, and others) real-time access to web search, local business data, jobs, e-commerce, real estate, finance, news, and more, through a single connection.
You need an OpenWeb Ninja API key. Get one atopenwebninja.com.
The server runs vianpx— there's nothing to install globally. Pick your client below;npxfetches@openwebninja/mcp-serveron demand.
Add toclaude_desktop_config.json(Settings -> Developer -> Edit Config):
{ "mcpServers": { "openwebninja": { "command": "npx", "args": ["-y", "@openwebninja/mcp-server"], "env": { "OPENWEBNINJA_API_KEY": "your-api-key" } } } }
claude mcp add openwebninja -e OPENWEBNINJA_API_KEY=your-api-key -- npx -y @openwebninja/mcp-server
Use the samecommand/args/envshape in the client's MCP config (mcp.jsonor equivalent).
git clone <repo> && cd openwebninja-mcp npm install npm run build
Then point your MCP client at the built entry:
{ "mcpServers": { "openwebninja": { "command": "node", "args": ["/absolute/path/to/openwebninja-mcp/dist/index.js"], "env": { "OPENWEBNINJA_API_KEY": "your-api-key" } } } }
Each tool maps to one OpenWeb Ninja API and takes two inputs:
- operation: which endpoint to call (e.g.search,product_details)
- args: the parameters for that operation
The tool description lists every operation and its required parameters. Example call to thejsearchtool:
{ "operation": "search", "args": { "query": "site reliability engineer remote", "country": "us" } }
Arguments are validated and type-coerced before the request is sent, and responses return the OpenWeb Ninjadatapayload plus arequest_id.
Search & discovery:realtime_web_search,realtime_news_data,real_time_news_search,realtime_forums_search,web_search_autocomplete,realtime_image_search,reverse_image_search,realtime_lens_data,real_time_video_search,realtime_shorts_search,ai_overviews,google_ai_mode,social_links_search
Local & maps:local_business_data,yelp_business_data,trustpilot_company_and_reviews,local_rank_tracker,driving_directions,waze,ev_charge_finder
Jobs & companies:jsearch,job_salary_data,realtime_glassdoor_data
Commerce & product:realtime_amazon_data,realtime_product_search,real_time_walmart_data,real_time_ebay_data,realtime_costco_data,real_time_wayfair_data,realtime_books_data,play_store_apps
Real estate:realtime_zillow_data,real_time_redfin_data
Finance & events:realtime_finance_data,realtime_events_data
Contact & enrichment:website_contacts_scraper,email_search
npm run sync # sync OpenAPI specs from S3 into openapi-cache/ (needs AWS creds) npm run generate # regenerate src/generated/manifest.ts from the specs npm run build # compile TypeScript to dist/ npm run dev # run the server over stdio (tsx, no build) npm run inspect # launch the MCP Inspector against the server npx tsx test/smoke.ts # smoke test: list tools + validation + request path
The pipeline is: OpenAPI specs (openapi-cache/) ->scripts/generate.ts->src/generated/manifest.ts-> tools registered at runtime insrc/server.ts. To add or update an API, re-sync the specs and regenerate; no hand-written per-tool code is needed (only the curated descriptions insrc/lib/descriptions.ts).
Search and retrieve rental property details from Daft.ie via web scraping.
Live Austin-area MLS listings in your AI assistant — active listings, property details, schools, taxes, and neighborhood data for the Austin metro. Free remote MCP server, no install.
Australian development application and property intelligence queries for AI agents.
Search distressed auction properties for investors
Provides comprehensive enterprise information query and analysis, including business info, risk analysis, intellectual property, and operational insights.
Search 1000+ Russian construction companies and real estate agencies for AI agents
Free public AI-readable real estate listing exchange. Five MCP tools to search, retrieve, and act on residential, commercial, FSBO and off-market listings.
Zillow Data API MCP server — 4 tools: property lookup by address, lookup by ZPID, Zestimate, and listing search. 300+ fields per home across 160M+ U.S. parcels in one REST call. Free tier: 100 credits, no card. Corrected re-submission of the existing api.zillapi.com/mcp listing (was 'nine tools', now 4).
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


