scrapeunblocker-mcp 0.11.0 → 0.12.0

package/dist/index.js

@@ -10,7 +10,7 @@ import { APIError, ScrapeUnblockerClient, errorForStatus } from "scrapeunblocker
 import { z } from "zod";
 
 // src/plugin-catalog.ts
-var CATEGORIES = ["Travel", "Google", "AI", "Search engines", "E-commerce", "Classifieds & Resale", "Groceries", "Real estate", "Vehicles", "Jobs", "Reviews & Companies", "Local & Maps", "Apps", "Video & Music", "SEO & Ads"];
+var CATEGORIES = ["Travel", "Google", "AI", "Search engines", "E-commerce", "Classifieds & Resale", "Groceries", "Real estate", "Vehicles", "Jobs", "Reviews & Companies", "Local & Maps", "Apps", "Video & Music", "Sports", "SEO & Ads"];
 var PLUGINS = [
   {
     "name": "skyscanner_flights",
@@ -5653,6 +5653,71 @@ var PLUGINS = [
       }
     ]
   },
+  {
+    "name": "bodegaaurrera_search",
+    "title": "Scrape Bodega Aurrera (Mexico) product search",
+    "category": "Groceries",
+    "path": "/groceries/bodegaaurrera-search",
+    "fixed": {},
+    "description": "Searches Bodega Aurrera (bodegaaurrera.com.mx, Walmart de Mexico) for `query` and returns `products`, each with `position`, `productId`, `name`, `brand`, `url`, `price` (MXN), `wasPrice` and `savings` (only on a promotion), `unitPrice`, `priceRange`, `rating`, `reviewCount`, `availability` / `availabilityText` / `inStock`, `seller` / `sellerType`, `salesUnit`, `department`, `category` (path), `badges`, `fulfillment` (pickup / delivery labels), `sponsored` and `image`. Also `totalResults`, `storeId` (the store the prices and availability are for: the one the storefront assigns a new visitor - a store or postal code cannot be chosen) and `nextPage`. Sort with `sort` (relevance, price_low, price_high), start at `page` and collect up to `max_results` across pages (about 40 per page, each page billed as one request, see `pagesFetched`). `url` takes a Bodega Aurrera search link instead of `query`. A results page usually takes 1-3 s; a page that has to be rendered in a browser takes 20-60 s.",
+    "params": [
+      {
+        "name": "query",
+        "type": "string",
+        "required": false,
+        "description": "What to search, e.g. 'leche', 'arroz', 'detergente' or 'pa\xF1ales'."
+      },
+      {
+        "name": "sort",
+        "type": "string",
+        "required": false,
+        "description": "Order: relevance, price_low, price_high.",
+        "default": "relevance"
+      },
+      {
+        "name": "page",
+        "type": "integer",
+        "required": false,
+        "description": "1-based results page to start from (1-25).",
+        "default": 1
+      },
+      {
+        "name": "max_results",
+        "type": "integer",
+        "required": false,
+        "description": "Products to collect across pages (1-220); about 44 per page, and each page read is billed as one request.",
+        "default": 44
+      },
+      {
+        "name": "url",
+        "type": "string",
+        "required": false,
+        "description": "Instead of `query`: a Bodega Aurrera search link, e.g. https://www.bodegaaurrera.com.mx/search?q=leche (its sort and page are used)."
+      }
+    ]
+  },
+  {
+    "name": "bodegaaurrera_product",
+    "title": "Scrape one Bodega Aurrera (Mexico) product",
+    "category": "Groceries",
+    "path": "/groceries/bodegaaurrera-product",
+    "fixed": {},
+    "description": "Fetches one Bodega Aurrera product (by `product_id` or `url`) and returns it as JSON: `productId`, `name`, `brand`, `url`, `upc`, `model`, `price` (MXN), `wasPrice` / `savings` (only on a promotion), `unitPrice`, `installments`, `availability` / `availabilityText` / `inStock`, `orderLimit`, `orderMinimum`, `salesUnit`, `seller` / `sellerId` / `sellerType`, `rating`, `reviewCount`, `ratingBreakdown` (1-5 stars), `category` (path), `productType`, `shortDescription`, `description`, `ingredients`, `specifications` (name / value), `badges`, `fulfillment` (pickup / delivery messages), `fulfillmentOptions`, `store` (the store the price and availability are for - the one the storefront assigns a new visitor) and `image` / `images`. A call usually takes 1-3 s, or 20-60 s when the page has to be rendered in a browser. Companion to `/groceries/bodegaaurrera-search`.",
+    "params": [
+      {
+        "name": "product_id",
+        "type": "string",
+        "required": false,
+        "description": "Bodega Aurrera item id, e.g. '00750649502153' (the number at the end of an /ip/ link; search results give it as `productId`)."
+      },
+      {
+        "name": "url",
+        "type": "string",
+        "required": false,
+        "description": "Instead of `product_id`: a Bodega Aurrera product link, e.g. https://www.bodegaaurrera.com.mx/ip/leche-great-value-entera-1-l/00750649502153."
+      }
+    ]
+  },
   {
     "name": "zillow_search",
     "title": "Scrape Zillow real-estate listings",
@@ -8155,6 +8220,239 @@ var PLUGINS = [
       }
     ]
   },
+  {
+    "name": "sofascore_events",
+    "title": "SofaScore matches of a sport on a day, or live now",
+    "category": "Sports",
+    "path": "/sports/sofascore-events",
+    "fixed": {},
+    "description": "Lists a sport's matches from sofascore.com for one day in your time zone (or `live=true` for those in progress), biggest competitions first, as JSON: `id`, `url`, `tournament` (id, name, url, category / country, stage), `season`, `round`, `status` (type notstarted, inprogress, finished, postponed, canceled, with its description such as '2nd half'), `startTime` (ISO, UTC) and `startTimestamp`, `homeTeam` / `awayTeam` (id, name, short name, code, country, url), `homeScore` / `awayScore` (current plus per-period and normal-time scores), `winner`, red cards, seeds and first server (tennis), venue and referee when known. Narrow with `country` (a country or category) or `tournament` (id, link or name), and `status`. Pass a match `id` to `/sports/sofascore-match` for its stats and lineups. Motorsport and cycling are races, not matches, and have no day list.",
+    "params": [
+      {
+        "name": "sport",
+        "type": "string",
+        "required": false,
+        "description": "The sport: football, basketball, tennis, ice-hockey, american-football, baseball, handball, volleyball, cricket, rugby, futsal, table-tennis, esports, darts, snooker, mma, aussie-rules, waterpolo, floorball, bandy, badminton, beach-volley, minifootball, padel, motorsport, cycling (soccer, hockey, nba, nfl and the like are accepted).",
+        "default": "football"
+      },
+      {
+        "name": "date",
+        "type": "string",
+        "required": false,
+        "description": "Day as YYYY-MM-DD, or today / yesterday / tomorrow (in `timezone`). Default today."
+      },
+      {
+        "name": "timezone",
+        "type": "string",
+        "required": false,
+        "description": "Time zone the day is read in: an IANA name ('Europe/London', 'America/New_York') or a UTC offset ('+02:00'). Default UTC."
+      },
+      {
+        "name": "live",
+        "type": "boolean",
+        "required": false,
+        "description": "true for the matches in progress right now (date is then ignored).",
+        "default": false
+      },
+      {
+        "name": "status",
+        "type": "string",
+        "required": false,
+        "description": "Keep only: all, live, upcoming, finished.",
+        "default": "all"
+      },
+      {
+        "name": "country",
+        "type": "string",
+        "required": false,
+        "description": "Only one country or category, by name, slug, ISO code or id: 'england', 'Spain', 'US', and for tennis 'ATP', 'WTA'."
+      },
+      {
+        "name": "tournament",
+        "type": "string",
+        "required": false,
+        "description": "Only one competition: an id, a sofascore.com tournament link or a name such as 'Premier League' or 'NBA'."
+      },
+      {
+        "name": "max_results",
+        "type": "integer",
+        "required": false,
+        "description": "Matches to return (1-500), the biggest competitions first.",
+        "default": 100
+      }
+    ]
+  },
+  {
+    "name": "sofascore_match",
+    "title": "One SofaScore match with stats, lineups and incidents",
+    "category": "Sports",
+    "path": "/sports/sofascore-match",
+    "fixed": {},
+    "description": "Fetches one match from sofascore.com: `event` (teams, score by period, status, start time, tournament, season, round, venue, referee) plus the `include` sections: `statistics` (per period and group, e.g. possession, expected goals, shots, with home / away text and numbers), `lineups` (formation, every player with position, shirt number, rating and match statistics, missing players), `incidents` (goals, cards, substitutions, VAR, periods, oldest first), `h2h` (team and manager records plus the last 10 meetings), `odds` (markets with decimal and fractional odds), `momentum`, `pregame_form`, `votes`, `managers`, `best_players` (player of the match and best rated per side), `shotmap` (every shot with xG, xGOT, body part and coordinates), `commentary` and `highlights`. Sections the site does not have for the match (e.g. statistics before kick-off) are named in `unavailable`.",
+    "params": [
+      {
+        "name": "match",
+        "type": "string",
+        "required": true,
+        "description": "The match: its id (e.g. 16363904, from the search or events endpoints) or a sofascore.com match link. A link without '#id:' names the pairing; the match in progress, else the next, else the latest is used."
+      },
+      {
+        "name": "include",
+        "type": "string",
+        "required": false,
+        "description": "Sections to add, comma separated: statistics, lineups, incidents, h2h, odds, momentum, pregame_form, votes, managers, best_players, shotmap, commentary, highlights (or all / none). Default statistics,lineups,incidents.",
+        "join": ","
+      }
+    ]
+  },
+  {
+    "name": "sofascore_search",
+    "title": "Search SofaScore teams, players, tournaments and matches",
+    "category": "Sports",
+    "path": "/sports/sofascore-search",
+    "fixed": {},
+    "description": "Searches sofascore.com for `query` and returns the matches as JSON, best first. Each result has `rank` (its place in the list), `type` (team, player, tournament, match, manager, referee or venue), `id`, `name`, `slug`, a sofascore.com `url`, `sport`, `country` and `followers`; a player adds `position`, `jerseyNumber` and its `team`, a tournament its `category`, a match the same fields as `/sports/sofascore-events`. `sport` keeps to one sport, `type` to one kind of result. Feed an `id` to `/sports/sofascore-team`, `-player`, `-tournament` or `-match`.",
+    "params": [
+      {
+        "name": "query",
+        "type": "string",
+        "required": true,
+        "description": "What to look for: a team, player, competition, match, manager, referee or venue name, e.g. 'real madrid', 'sinner', 'premier league', 'arsenal chelsea'."
+      },
+      {
+        "name": "sport",
+        "type": "string",
+        "required": false,
+        "description": "The sport: football, basketball, tennis, ice-hockey, american-football, baseball, handball, volleyball, cricket, rugby, futsal, table-tennis, esports, darts, snooker, mma, aussie-rules, waterpolo, floorball, bandy, badminton, beach-volley, minifootball, padel, motorsport, cycling (soccer, hockey, nba, nfl and the like are accepted). Optional; narrows the search or name lookup to one sport."
+      },
+      {
+        "name": "type",
+        "type": "string",
+        "required": false,
+        "description": "Kind of result: all, teams, players, tournaments, matches, managers, referees, venues (all mixes them, best match first).",
+        "default": "all"
+      },
+      {
+        "name": "page",
+        "type": "integer",
+        "required": false,
+        "description": "1-based results page to start from (1-5); the site serves 20 per page.",
+        "default": 1
+      },
+      {
+        "name": "max_results",
+        "type": "integer",
+        "required": false,
+        "description": "Results to collect across pages (1-100).",
+        "default": 20
+      }
+    ]
+  },
+  {
+    "name": "sofascore_team",
+    "title": "A SofaScore team with matches, squad and transfers",
+    "category": "Sports",
+    "path": "/sports/sofascore-team",
+    "fixed": {},
+    "description": "Fetches a team from sofascore.com (tennis players and other individual competitors are teams there too): `team` (name, short name, code, country, category, main tournament, manager, venue with capacity, foundation date, followers, url) plus the `include` sections: `last_matches` (most recent first) and `next_matches` (soonest first) in the events shape, `squad` (players with position, shirt number, birth date, height, foot, country, market value, contract), `tournaments` the team plays and `transfers` (in and out with fee and date). `team` takes an id, a link or a name.",
+    "params": [
+      {
+        "name": "team",
+        "type": "string",
+        "required": true,
+        "description": "The team (or a tennis player, MMA fighter and other individual competitors): its id (e.g. 2829), a sofascore.com team link, or a name such as 'Real Madrid' (best search match)."
+      },
+      {
+        "name": "sport",
+        "type": "string",
+        "required": false,
+        "description": "The sport: football, basketball, tennis, ice-hockey, american-football, baseball, handball, volleyball, cricket, rugby, futsal, table-tennis, esports, darts, snooker, mma, aussie-rules, waterpolo, floorball, bandy, badminton, beach-volley, minifootball, padel, motorsport, cycling (soccer, hockey, nba, nfl and the like are accepted). Optional; narrows the search or name lookup to one sport."
+      },
+      {
+        "name": "include",
+        "type": "string",
+        "required": false,
+        "description": "Sections to add, comma separated: last_matches, next_matches, squad, tournaments, transfers (or all / none). Default last_matches,next_matches.",
+        "join": ","
+      }
+    ]
+  },
+  {
+    "name": "sofascore_player",
+    "title": "A SofaScore player with season stats and matches",
+    "category": "Sports",
+    "path": "/sports/sofascore-player",
+    "fixed": {},
+    "description": "Fetches a player from sofascore.com: `player` (name, team, position and detailed positions, shirt number, birth date, height, preferred foot, country, market value, contract end, followers, url) plus the `include` sections: `season_stats` (every statistic SofaScore keeps for one competition and season, e.g. rating, goals, expected goals, assists, passes, duels, saves), `seasons` (each competition with its seasons, to pick `tournament` and `season`), `last_matches` (most recent first, with the player's rating, minutes and goals or assists in each), `transfers`, `attributes` (attacking, technical, tactical, defending, creativity scores) and `national_team` (caps, goals, debut). `player` takes an id, a link or a name.",
+    "params": [
+      {
+        "name": "player",
+        "type": "string",
+        "required": true,
+        "description": "The player: id (e.g. 12994), a sofascore.com player link, or a name such as 'Lionel Messi' (best search match)."
+      },
+      {
+        "name": "sport",
+        "type": "string",
+        "required": false,
+        "description": "The sport: football, basketball, tennis, ice-hockey, american-football, baseball, handball, volleyball, cricket, rugby, futsal, table-tennis, esports, darts, snooker, mma, aussie-rules, waterpolo, floorball, bandy, badminton, beach-volley, minifootball, padel, motorsport, cycling (soccer, hockey, nba, nfl and the like are accepted). Optional; narrows the search or name lookup to one sport."
+      },
+      {
+        "name": "include",
+        "type": "string",
+        "required": false,
+        "description": "Sections to add, comma separated: seasons, season_stats, last_matches, transfers, attributes, national_team (or all / none). Default season_stats,last_matches.",
+        "join": ","
+      },
+      {
+        "name": "tournament",
+        "type": "string",
+        "required": false,
+        "description": "For season_stats: the competition id (see the seasons section). Default the player's first listed competition."
+      },
+      {
+        "name": "season",
+        "type": "string",
+        "required": false,
+        "description": "For season_stats: a season id or its year as SofaScore writes it ('26/27', '2026'). Default the latest."
+      }
+    ]
+  },
+  {
+    "name": "sofascore_tournament",
+    "title": "A SofaScore competition with standings and fixtures",
+    "category": "Sports",
+    "path": "/sports/sofascore-tournament",
+    "fixed": {},
+    "description": "Fetches a competition and season from sofascore.com: `tournament` (name, category / country, tier, title holder and record holders, divisions above and below, dates, followers, url) and `season`, plus the `include` sections: `standings` (every table: position, team, played, won, drawn, lost, scored, conceded, difference, points, promotion or relegation note), `rounds`, `last_matches` (most recent first) and `next_matches` (soonest first) in the events shape, `top_players` and `top_teams` (the top 10 in each statistic, e.g. rating, goals, assists, expected goals) and `seasons` (every season with its id). `tournament` takes an id, a link or a name.",
+    "params": [
+      {
+        "name": "tournament",
+        "type": "string",
+        "required": true,
+        "description": "The competition: id (e.g. 17), a sofascore.com tournament link (its '#id:' picks the season), or a name such as 'Premier League' or 'NBA' (best search match)."
+      },
+      {
+        "name": "sport",
+        "type": "string",
+        "required": false,
+        "description": "The sport: football, basketball, tennis, ice-hockey, american-football, baseball, handball, volleyball, cricket, rugby, futsal, table-tennis, esports, darts, snooker, mma, aussie-rules, waterpolo, floorball, bandy, badminton, beach-volley, minifootball, padel, motorsport, cycling (soccer, hockey, nba, nfl and the like are accepted). Optional; narrows the search or name lookup to one sport."
+      },
+      {
+        "name": "season",
+        "type": "string",
+        "required": false,
+        "description": "A season id or its year as SofaScore writes it ('26/27', '2026'). Default the current one."
+      },
+      {
+        "name": "include",
+        "type": "string",
+        "required": false,
+        "description": "Sections to add, comma separated: seasons, standings, rounds, last_matches, next_matches, top_players, top_teams (or all / none). Default standings,last_matches,next_matches.",
+        "join": ","
+      }
+    ]
+  },
   {
     "name": "similarweb_overview",
     "title": "Get a website's Similarweb traffic overview",
@@ -8650,7 +8948,7 @@ ${body}`);
 }
 
 // src/index.ts
-var VERSION = "0.11.0";
+var VERSION = "0.12.0";
 var DEFAULT_BASE_URL = "https://api.scrapeunblocker.com";
 var API_KEY_HEADER = "x-scrapeunblocker-key";
 function resolveApiKey() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapeunblocker-mcp",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "mcpName": "com.scrapeunblocker/scrapeunblocker-mcp",
   "description": "Model Context Protocol (MCP) server for ScrapeUnblocker - lets Claude fetch any web page's HTML (or AI-parsed JSON) and run 100+ site plugins that return structured JSON, through the ScrapeUnblocker anti-bot API, using your own API key.",
   "keywords": [