{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "mcp.easyparser.com",
    "site": "easyparser.com",
    "addresses": [
      {
        "address": "172.67.68.44",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.64.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.26.2.86",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.26.0.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.26.3.86",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.26.0.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:20::ac43:442c",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:20::/44",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:20::681a:356",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "prefix": "2606:4700:20::/44",
          "country": "US",
          "name": "CLOUDFLARENET - Cloudflare, Inc."
        }
      },
      {
        "address": "2606:4700:20::681a:256",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "prefix": "2606:4700:20::/44",
          "country": "US",
          "name": "CLOUDFLARENET - Cloudflare, Inc."
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "172.67.68.44",
          "104.26.2.86",
          "104.26.3.86",
          "2606:4700:20::ac43:442c",
          "2606:4700:20::681a:356",
          "2606:4700:20::681a:256"
        ],
        "first_seen": "2026-11-22T14:19:02.497Z",
        "last_seen": "2026-11-22T14:19:02.497Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "easyparser-mcp",
      "version": "1.5.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare",
      "strict-transport-security": "max-age=31536000; includeSubDomains"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "com.easyparser",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/easyparser-com/mcp-easyparser",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "9197",
    "server_name": "com.easyparser/easyparser",
    "url": "https://mcp.easyparser.com/mcp",
    "host": "mcp.easyparser.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T14:19:02.497Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "1a430833ea871c6e2246941f3dd2c56b8fdcf0a298c286aa93c447cfa01f5158",
    "first_listed_at": "2026-11-21T08:11:02.793Z",
    "created_at": "2026-11-21T05:40:11.155Z",
    "resolved_addresses": [
      "172.67.68.44",
      "104.26.2.86",
      "104.26.3.86",
      "2606:4700:20::ac43:442c",
      "2606:4700:20::681a:356",
      "2606:4700:20::681a:256"
    ]
  },
  "server": {
    "name": "com.easyparser/easyparser",
    "title": "Easyparser: Amazon Product & Seller Data",
    "description": "Real-time Amazon product, seller, and search data for AI agents across 22 marketplaces.",
    "version": "1.5.0",
    "registry_status": "active",
    "repository_url": "https://github.com/easyparser-com/mcp-easyparser",
    "website_url": "https://easyparser.com",
    "published_at": "2026-11-12T17:50:11.791Z",
    "updated_at": "2026-11-12T17:50:11.791Z",
    "first_seen": "2026-11-21T05:40:10.522Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:08:08.145Z"
  },
  "operator": null,
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 1096,
    "first_check_in_window": "2026-11-21T08:11:02.793Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "1a430833ea871c6e2246941f3dd2c56b8fdcf0a298c286aa93c447cfa01f5158",
    "tools": 18,
    "resources": 3,
    "prompts": 5,
    "first_seen": "2026-11-21T08:11:03.840Z",
    "tool_names": [
      "get_product_detail",
      "get_product_offers",
      "search_products",
      "lookup_product",
      "get_sales_history",
      "get_bestseller_rank",
      "get_package_dimensions",
      "get_similar_products",
      "get_seller_profile",
      "get_seller_products",
      "get_seller_feedback",
      "list_operations",
      "list_bulk_jobs",
      "get_bulk_job_items",
      "get_bulk_item_result",
      "get_bulk_webhook_logs",
      "get_error_logs",
      "check_credits"
    ],
    "declared": {
      "tools": [
        {
          "name": "get_product_detail",
          "description": "Fetch complete, structured information about a single Amazon product: title, brand, images, feature bullets, description, Buy Box price and availability, Prime eligibility, rating and review count, Best Sellers Rank, category path, variants, specifications, and top reviews. This is the primary tool for product analysis, listing enrichment, and price monitoring.\n\nUse this tool when you need a full product profile. If you only need competing seller prices, use get_product_offers instead (cheaper context). If you only need the sales rank, use get_bestseller_rank. If you only need shipping dimensions or the FBA fee category, use get_package_dimensions.\n\nProvide EITHER the identifier field OR url, never both. Costs 1 credit; set a_plus_content to true only when the user explicitly asks about enhanced brand content, as it costs 1 extra credit.\n\nTo see what a shopper at a specific location sees (price, availability, delivery date), pass the inline address fields (zip_code, or city/district/country_code where the domain needs them); no setup is needed. A new location is saved to the account and counts once against the plan's address limit; repeat requests for the same location reuse it. Requests with inline address fields can take up to 45 seconds. Check applied_address in the response: if it does not contain the values you sent, the address was not applied.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "description": "Full Amazon product URL (e.g. https://www.amazon.com/dp/B0CJB6V2L5). Use this when the user pastes a link instead of an ASIN."
              },
              "asin": {
                "type": "string",
                "pattern": "^[A-Z0-9]{10}$",
                "description": "Amazon Standard Identification Number, a 10-character alphanumeric product identifier (e.g. B0CJB6V2L5). Found in the product URL after /dp/ or /gp/product/."
              },
              "city": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: city. Only for .com.au (with zip_code, e.g. 'KEW'), .ae (with district, e.g. 'Abu Dhabi'), .sa and .eg (alone, one of Amazon's delivery cities, e.g. 'Riyadh'). Do not send it on other domains."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              },
              "currency": {
                "type": "string",
                "description": "ISO currency code for price display (e.g. usd, eur, try). Prices are converted by Amazon's own display logic."
              },
              "district": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: area within city. Only on .ae, together with city (e.g. 'ADCO Compound')."
              },
              "language": {
                "type": "string",
                "description": "Language code for the Amazon page, in locale format (e.g. en_US, de_DE, tr_TR). Affects the language of titles, descriptions and reviews in the response."
              },
              "zip_code": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: ZIP or postal code, so prices, availability and delivery dates match a shopper at that location. Examples: '10001' on .com, 'SW1A 1AA' on .co.uk. Join two-part codes with a comma: 'N0E,1Y0' on .ca, '01310,100' on .com.br, '241,0014' on .co.jp. On .com.au send it with city."
              },
              "seller_id": {
                "type": "string",
                "description": "Fetch the product as offered by a specific seller (their Seller ID). Only use when the user asks about a specific merchant's offer."
              },
              "address_id": {
                "type": "integer",
                "description": "ID of an Active saved address for the same domain, from https://app.easyparser.com/addresses. Only use it when the user gives an address ID. For a ZIP code or city, use the inline fields instead. Inline fields override address_id.",
                "exclusiveMinimum": 0
              },
              "country_code": {
                "type": "string",
                "minLength": 2,
                "description": "Inline delivery address: destination country for cross-border delivery as an ISO 3166-1 alpha-2 code (e.g. 'GB' on .com). On .nl only 'NL' or 'BE'."
              },
              "a_plus_content": {
                "type": "boolean",
                "default": false,
                "description": "Set true to include the 'From the manufacturer' A+ enhanced brand content. Costs 1 additional credit. Default false."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_product_offers",
          "description": "Fetch the list of seller offers for an Amazon product: every merchant selling the item with their price, shipping cost, condition (new/used), fulfillment type (FBA/FBM), and seller rating. Also returns the Buy Box winner. This is the tool for competitive price analysis, reseller monitoring, and availability tracking.\n\nUse this tool when the question is about WHO sells the product and at WHAT price. If you need the product's own details (title, images, rating), use get_product_detail instead.\n\nEach requested page costs 1 credit. Start with a single page (default) and only increase max_page if the user needs the full offer list. Use the condition and shipping filters to narrow results instead of paginating; it is cheaper.\n\nTo see what a shopper at a specific location sees (price, availability, delivery date), pass the inline address fields (zip_code, or city/district/country_code where the domain needs them); no setup is needed. A new location is saved to the account and counts once against the plan's address limit; repeat requests for the same location reuse it. Requests with inline address fields can take up to 45 seconds. Check applied_address in the response: if it does not contain the values you sent, the address was not applied.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "asin"
            ],
            "properties": {
              "asin": {
                "type": "string",
                "pattern": "^[A-Z0-9]{10}$",
                "description": "Amazon Standard Identification Number, a 10-character alphanumeric product identifier (e.g. B0CJB6V2L5). Found in the product URL after /dp/ or /gp/product/."
              },
              "city": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: city. Only for .com.au (with zip_code, e.g. 'KEW'), .ae (with district, e.g. 'Abu Dhabi'), .sa and .eg (alone, one of Amazon's delivery cities, e.g. 'Riyadh'). Do not send it on other domains."
              },
              "prime": {
                "type": "boolean",
                "description": "If true, return only Prime-eligible offers."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              },
              "district": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: area within city. Only on .ae, together with city (e.g. 'ADCO Compound')."
              },
              "max_page": {
                "type": "integer",
                "default": 1,
                "maximum": 5,
                "minimum": 1,
                "description": "Ending page number. Each page costs 1 credit; max 5 pages per request. Default 1."
              },
              "min_page": {
                "type": "integer",
                "default": 1,
                "minimum": 1,
                "description": "Starting page number. Default 1."
              },
              "zip_code": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: ZIP or postal code, so prices, availability and delivery dates match a shopper at that location. Examples: '10001' on .com, 'SW1A 1AA' on .co.uk. Join two-part codes with a comma: 'N0E,1Y0' on .ca, '01310,100' on .com.br, '241,0014' on .co.jp. On .com.au send it with city."
              },
              "condition": {
                "enum": [
                  "new",
                  "used_like_new",
                  "used_very_good",
                  "used_good",
                  "used_acceptable"
                ],
                "type": "string",
                "description": "Filter offers by item condition. Omit to include all conditions."
              },
              "address_id": {
                "type": "integer",
                "description": "ID of an Active saved address for the same domain, from https://app.easyparser.com/addresses. Only use it when the user gives an address ID. For a ZIP code or city, use the inline fields instead. Inline fields override address_id.",
                "exclusiveMinimum": 0
              },
              "country_code": {
                "type": "string",
                "minLength": 2,
                "description": "Inline delivery address: destination country for cross-border delivery as an ISO 3166-1 alpha-2 code (e.g. 'GB' on .com). On .nl only 'NL' or 'BE'."
              },
              "free_shipping": {
                "type": "boolean",
                "description": "If true, return only offers with free shipping."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "search_products",
          "description": "Search Amazon by keyword or a full search/category URL and get structured product listings: ASIN, title, price, rating, review count, Prime status, and badges (Best Seller, Amazon's Choice) for each result. Also returns the available refinement filters (category, brand, price range) with their IDs.\n\nUse this tool for market research, keyword analysis, and product discovery. If the user already has an ASIN or product URL, do NOT search; use get_product_detail directly.\n\nEach page costs 1 credit. One page typically returns 20-40 products, which is enough for most questions. Use sort_by and exclude_sponsored to improve result quality instead of fetching more pages. To filter by category or brand, first run one search and read the refinements field in the response to discover valid filter IDs, then pass them in refinements.\n\nTo see what a shopper at a specific location sees (price, availability, delivery date), pass the inline address fields (zip_code, or city/district/country_code where the domain needs them); no setup is needed. A new location is saved to the account and counts once against the plan's address limit; repeat requests for the same location reuse it. Requests with inline address fields can take up to 45 seconds. Check applied_address in the response: if it does not contain the values you sent, the address was not applied.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "description": "Full Amazon search or category URL. Use when the user pastes an Amazon link containing filters. Mutually exclusive with keyword."
              },
              "city": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: city. Only for .com.au (with zip_code, e.g. 'KEW'), .ae (with district, e.g. 'Abu Dhabi'), .sa and .eg (alone, one of Amazon's delivery cities, e.g. 'Riyadh'). Do not send it on other domains."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              },
              "keyword": {
                "type": "string",
                "description": "Search query as a user would type it into Amazon (e.g. 'stainless steel water bottle 40oz'). Mutually exclusive with url."
              },
              "sort_by": {
                "enum": [
                  "featured",
                  "price-asc-rank",
                  "price-desc-rank",
                  "review-rank",
                  "date-desc-rank",
                  "exact-aware-popularity-rank"
                ],
                "type": "string",
                "default": "featured",
                "description": "Result ordering. 'featured' is Amazon's default; 'price-asc-rank' cheapest first; 'price-desc-rank' most expensive; 'review-rank' most reviewed; 'date-desc-rank' newest listings; 'exact-aware-popularity-rank' by popularity."
              },
              "currency": {
                "type": "string",
                "description": "ISO currency code for price display (e.g. usd, eur, try). Prices are converted by Amazon's own display logic."
              },
              "district": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: area within city. Only on .ae, together with city (e.g. 'ADCO Compound')."
              },
              "language": {
                "type": "string",
                "description": "Language code for the Amazon page, in locale format (e.g. en_US, de_DE, tr_TR). Affects the language of titles, descriptions and reviews in the response."
              },
              "max_page": {
                "type": "integer",
                "default": 1,
                "maximum": 5,
                "minimum": 1,
                "description": "Ending page number. Each page costs 1 credit; max 5 pages per request. Default 1."
              },
              "min_page": {
                "type": "integer",
                "default": 1,
                "minimum": 1,
                "description": "Starting page number. Default 1."
              },
              "zip_code": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: ZIP or postal code, so prices, availability and delivery dates match a shopper at that location. Examples: '10001' on .com, 'SW1A 1AA' on .co.uk. Join two-part codes with a comma: 'N0E,1Y0' on .ca, '01310,100' on .com.br, '241,0014' on .co.jp. On .com.au send it with city."
              },
              "address_id": {
                "type": "integer",
                "description": "ID of an Active saved address for the same domain, from https://app.easyparser.com/addresses. Only use it when the user gives an address ID. For a ZIP code or city, use the inline fields instead. Inline fields override address_id.",
                "exclusiveMinimum": 0
              },
              "refinements": {
                "type": "string",
                "description": "Category/attribute filters in Amazon's format: 'n:<category_id>,p_<filter_group>:<filter_id>'. Discover valid IDs from the refinements field of a previous search response. Example: 'n:7141123011,p_123:502215'."
              },
              "country_code": {
                "type": "string",
                "minLength": 2,
                "description": "Inline delivery address: destination country for cross-border delivery as an ISO 3166-1 alpha-2 code (e.g. 'GB' on .com). On .nl only 'NL' or 'BE'."
              },
              "exclude_sponsored": {
                "type": "boolean",
                "default": false,
                "description": "If true, removes sponsored (paid ad) products from results. Recommended true for organic market analysis."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "lookup_product",
          "description": "Convert an external product identifier (UPC, EAN, GTIN, ISBN, JAN, MINSAN) into the corresponding Amazon ASIN, with an essential product snapshot. This is the bridge between manufacturer/retail barcodes and the Amazon ecosystem.\n\nUse this tool when the user has a barcode or standard product code and wants to find the matching Amazon listing. Typical workflows: catalog matching, inventory synchronization, converting supplier data into Amazon ASINs. Also accepts ASIN as input type if you need to validate one.\n\nYou MUST set identifier_type to match the code you have. Guessing the wrong type returns no results. UPC is 12 digits, EAN/GTIN is 13, ISBN is 10 or 13 (books). If the user gives a keyword instead of a code, use search_products instead. Costs 1 credit.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "identifier",
              "identifier_type"
            ],
            "properties": {
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              },
              "identifier": {
                "type": "string",
                "description": "The product code value (e.g. '724382975021' for a UPC). Digits only for barcode types."
              },
              "identifier_type": {
                "enum": [
                  "ASIN",
                  "EAN",
                  "GTIN",
                  "ISBN",
                  "JAN",
                  "MINSAN",
                  "UPC"
                ],
                "type": "string",
                "description": "The type of code provided. UPC: 12-digit US barcode. EAN/GTIN: 13-digit international barcode. ISBN: book identifier. JAN: Japanese barcode. MINSAN: Italian pharma code. ASIN: Amazon's own identifier."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_sales_history",
          "description": "Retrieve a product's historical performance over up to 12 months: weekly aggregated trends for estimated views/traffic, sales, price, and Best Sellers Rank. This is Easyparser's 'time machine', the deepest competitive-intelligence tool in this server.\n\nUse this tool for trend forecasting, seasonality analysis, conversion-rate estimation, and investment/sourcing due diligence. Do NOT use it for a simple current price check; get_product_detail is 5x cheaper for that.\n\nIMPORTANT cost rule: the base cost is 5 credits, and each month of history adds 1 credit (3 months = 8 credits, 12 months = 17 credits). Always ask the user how far back they need, or default to 3 months for a quick trend read. The history array in the response is aggregated by WEEK, not by day.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "asin"
            ],
            "properties": {
              "asin": {
                "type": "string",
                "pattern": "^[A-Z0-9]{10}$",
                "description": "Amazon Standard Identification Number, a 10-character alphanumeric product identifier (e.g. B0CJB6V2L5). Found in the product URL after /dp/ or /gp/product/."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              },
              "history_range": {
                "enum": [
                  "0",
                  "3",
                  "6",
                  "9",
                  "12"
                ],
                "type": "string",
                "default": "0",
                "description": "Depth of historical data in months. '0' returns only the current snapshot (5 credits). '3', '6', '9', '12' add weekly history at +1 credit per month. Default '0'."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_bestseller_rank",
          "description": "Get a product's current Best Sellers Rank (BSR): its numerical rank in main categories and sub-category node identifiers. A lightweight, single-purpose tool for popularity and demand tracking.\n\nUse this tool when you only need the rank, e.g. 'Is this product selling well?' or daily rank monitoring. Lower rank number means higher sales velocity. If you also need price, rating or content, use get_product_detail instead (it includes BSR along with everything else). For historical rank trends, use get_sales_history. Costs 1 credit.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "asin"
            ],
            "properties": {
              "asin": {
                "type": "string",
                "pattern": "^[A-Z0-9]{10}$",
                "description": "Amazon Standard Identification Number, a 10-character alphanumeric product identifier (e.g. B0CJB6V2L5). Found in the product URL after /dp/ or /gp/product/."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_package_dimensions",
          "description": "Get a product's precise physical and logistical attributes: package height, width, length, weight, and its Amazon fee category (e.g. Computers, Apparel). This is the FBA fee-estimation and shipping-cost tool.\n\nUse this tool when the question is about shipping, storage, FBA fees, or warehouse planning. Do NOT use it for general product info: get_product_detail includes a human-readable dimensions string, but only THIS tool returns the structured fee category and exact measurements needed for fee calculation. Costs 1 credit.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "asin"
            ],
            "properties": {
              "asin": {
                "type": "string",
                "pattern": "^[A-Z0-9]{10}$",
                "description": "Amazon Standard Identification Number, a 10-character alphanumeric product identifier (e.g. B0CJB6V2L5). Found in the product URL after /dp/ or /gp/product/."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_similar_products",
          "description": "Find products Amazon considers similar to a given ASIN: returns the source product plus a 'similar' list of related ASINs with title, brand, category and image. This is the competitor and alternative discovery tool.\n\nUse this tool when the user asks for alternatives, competing products, or 'what else is like this?' for a specific ASIN. For keyword-based discovery without a starting product, use search_products instead. To compare the found products in depth, follow up with get_product_detail on the ASINs that matter.\n\nCost depends on similar_limit: 10 results = 1 credit (default), 50 = 6 credits, 100 = 11 credits. If no similar products are found, only 1 credit is charged. Keep the default 10 unless the user asks for a broad list. Delivery-address localization is not supported for this operation.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "asin"
            ],
            "properties": {
              "asin": {
                "type": "string",
                "pattern": "^[A-Z0-9]{10}$",
                "description": "Amazon Standard Identification Number, a 10-character alphanumeric product identifier (e.g. B0CJB6V2L5). Found in the product URL after /dp/ or /gp/product/."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              },
              "similar_limit": {
                "enum": [
                  "10",
                  "50",
                  "100"
                ],
                "type": "string",
                "default": "10",
                "description": "Maximum number of similar products to return: '10' (1 credit, default), '50' (6 credits) or '100' (11 credits)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_seller_profile",
          "description": "Unmask the legal identity and reputation of any Amazon merchant: legal business name, registered business address, and granular feedback trends over 30/90/365 days and lifetime. This is the supplier-verification and brand-protection tool.\n\nUse this tool when the user asks 'who is this seller?', 'is this merchant legitimate?', or needs a supplier's legal entity for compliance or invoicing. To see WHAT the seller sells, use get_seller_products. To read individual buyer reviews about the seller, use get_seller_feedback.\n\nProvide EITHER seller_id OR url, never both. You can discover a product's seller by calling get_product_offers first. Costs 1 credit.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "description": "Full Amazon seller profile or storefront URL (e.g. https://www.amazon.com/sp?seller=A1MCYUGJD2ILFU)."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              },
              "language": {
                "type": "string",
                "description": "Language code for the Amazon page, in locale format (e.g. en_US, de_DE, tr_TR). Affects the language of titles, descriptions and reviews in the response."
              },
              "seller_id": {
                "type": "string",
                "minLength": 5,
                "description": "Amazon's unique seller identifier (e.g. A1MCYUGJD2ILFU). Found in seller profile URLs as the 'seller=' or 'me=' parameter."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_seller_products",
          "description": "Extract a seller's full product catalog: every ASIN they sell with brand, category, price, Prime status, variant counts, and rating data. Also returns dynamic refinement filters (department, shipping, sustainability) for drilling into the catalog.\n\nUse this tool for competitor inventory analysis, stock monitoring, and pricing-strategy research. If you need the seller's legal identity or reputation instead of their products, use get_seller_profile.\n\nEach page costs 1 credit. Start with one page and use sort_by (e.g. 'exact-aware-popularity-rank' for best sellers first) to surface the most relevant products early. Provide EITHER seller_id OR url, never both.\n\nTo see what a shopper at a specific location sees (price, availability, delivery date), pass the inline address fields (zip_code, or city/district/country_code where the domain needs them); no setup is needed. A new location is saved to the account and counts once against the plan's address limit; repeat requests for the same location reuse it. Requests with inline address fields can take up to 45 seconds. Check applied_address in the response: if it does not contain the values you sent, the address was not applied.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "description": "Full Amazon seller profile or storefront URL (e.g. https://www.amazon.com/sp?seller=A1MCYUGJD2ILFU)."
              },
              "city": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: city. Only for .com.au (with zip_code, e.g. 'KEW'), .ae (with district, e.g. 'Abu Dhabi'), .sa and .eg (alone, one of Amazon's delivery cities, e.g. 'Riyadh'). Do not send it on other domains."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              },
              "sort_by": {
                "type": "string",
                "description": "Catalog ordering. 'featured-rank' is default; 'exact-aware-popularity-rank' sorts by popularity (best sellers first); 'price-asc-rank'/'price-desc-rank' by price; 'date-desc-rank' by newest."
              },
              "district": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: area within city. Only on .ae, together with city (e.g. 'ADCO Compound')."
              },
              "language": {
                "type": "string",
                "description": "Language code for the Amazon page, in locale format (e.g. en_US, de_DE, tr_TR). Affects the language of titles, descriptions and reviews in the response."
              },
              "max_page": {
                "type": "integer",
                "default": 1,
                "maximum": 5,
                "minimum": 1,
                "description": "Ending page number. Each page costs 1 credit; max 5 pages per request. Default 1."
              },
              "min_page": {
                "type": "integer",
                "default": 1,
                "minimum": 1,
                "description": "Starting page number. Default 1."
              },
              "zip_code": {
                "type": "string",
                "minLength": 1,
                "description": "Inline delivery address: ZIP or postal code, so prices, availability and delivery dates match a shopper at that location. Examples: '10001' on .com, 'SW1A 1AA' on .co.uk. Join two-part codes with a comma: 'N0E,1Y0' on .ca, '01310,100' on .com.br, '241,0014' on .co.jp. On .com.au send it with city."
              },
              "seller_id": {
                "type": "string",
                "minLength": 5,
                "description": "Amazon's unique seller identifier (e.g. A1MCYUGJD2ILFU). Found in seller profile URLs as the 'seller=' or 'me=' parameter."
              },
              "address_id": {
                "type": "integer",
                "description": "ID of an Active saved address for the same domain, from https://app.easyparser.com/addresses. Only use it when the user gives an address ID. For a ZIP code or city, use the inline fields instead. Inline fields override address_id.",
                "exclusiveMinimum": 0
              },
              "country_code": {
                "type": "string",
                "minLength": 2,
                "description": "Inline delivery address: destination country for cross-border delivery as an ISO 3166-1 alpha-2 code (e.g. 'GB' on .com). On .nl only 'NL' or 'BE'."
              },
              "exclude_refinements": {
                "type": "boolean",
                "default": false,
                "description": "If true, omits the refinement filter list from the response, reducing payload size. Default false."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_seller_feedback",
          "description": "Read individual buyer feedback entries for an Amazon seller: star ratings, comment text, and dates, filterable by rating range and time period. This is the reputation deep-dive tool.\n\nUse this tool when the user wants to read actual buyer comments about a seller, analyze complaint patterns, or audit service quality. For aggregate reputation scores (30/90/365-day percentages) without individual comments, get_seller_profile is sufficient and cheaper in context.\n\nEach page costs 1 credit. To find dissatisfied customers, set max_rating to 3 instead of paging through everything.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "seller_id"
            ],
            "properties": {
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "default": ".com",
                "description": "Amazon marketplace domain extension. Determines the regional Amazon site the data is fetched from. Use the domain that matches the user's market, because prices, availability and rankings differ across marketplaces."
              },
              "max_page": {
                "type": "integer",
                "default": 1,
                "maximum": 5,
                "minimum": 1,
                "description": "Ending page number. Each page costs 1 credit; max 5 pages per request. Default 1."
              },
              "min_page": {
                "type": "integer",
                "default": 1,
                "minimum": 1,
                "description": "Starting page number. Default 1."
              },
              "seller_id": {
                "type": "string",
                "minLength": 5,
                "description": "Amazon's unique seller identifier (e.g. A1MCYUGJD2ILFU). Found in seller profile URLs as the 'seller=' or 'me=' parameter."
              },
              "max_rating": {
                "type": "integer",
                "default": 5,
                "maximum": 5,
                "minimum": 1,
                "description": "Maximum star rating to include (1-5). Set to 3 to focus on negative feedback. Default 5."
              },
              "min_rating": {
                "type": "integer",
                "default": 1,
                "maximum": 5,
                "minimum": 1,
                "description": "Minimum star rating to include (1-5). Default 1."
              },
              "history_range": {
                "enum": [
                  "1",
                  "3",
                  "12",
                  "all"
                ],
                "type": "string",
                "default": "all",
                "description": "Time period filter: '1' or '3' or '12' for months, 'all' for everything. Default 'all'."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "success",
              "operation"
            ],
            "properties": {
              "data": {
                "description": "Parsed Amazon data for the operation."
              },
              "success": {
                "type": "boolean",
                "description": "True when the request completed."
              },
              "operation": {
                "type": "string",
                "description": "Easyparser operation that ran, e.g. DETAIL or OFFER."
              },
              "request_id": {
                "type": "string",
                "description": "Easyparser request ID, useful for support and error logs."
              },
              "credits_used": {
                "type": "number",
                "description": "Credits charged for this request."
              },
              "applied_address": {
                "type": "object",
                "description": "Delivery address the request used (zipCode array, city, district, country_code). Without address fields this is the marketplace default.",
                "additionalProperties": {}
              },
              "credits_remaining": {
                "type": "number",
                "description": "Credits left on the account after this request."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_operations",
          "description": "List all Easyparser operations available in this server, with their parameters, credit costs, and example use cases. Works WITHOUT an API key: call this first to understand what the server can do, or when you are unsure which tool fits the user's question. Also returns the list of supported Amazon marketplace domains.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "operation": {
                "enum": [
                  "DETAIL",
                  "OFFER",
                  "SEARCH",
                  "PRODUCT_LOOKUP",
                  "SALES_ANALYSIS_HISTORY",
                  "BEST_SELLERS_RANK",
                  "PACKAGE_DIMENSION",
                  "SIMILAR_PRODUCTS",
                  "SELLER_PROFILE",
                  "SELLER_PRODUCTS",
                  "SELLER_FEEDBACK"
                ],
                "type": "string",
                "description": "Optional. Get the usage guide for one operation instead of the whole catalog."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "server",
              "operations",
              "supported_domains",
              "signup",
              "note"
            ],
            "properties": {
              "note": {
                "type": "string"
              },
              "server": {
                "type": "string"
              },
              "signup": {
                "type": "string"
              },
              "operations": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "operation",
                    "tool",
                    "cost",
                    "input",
                    "use_case"
                  ],
                  "properties": {
                    "cost": {
                      "type": "string"
                    },
                    "tool": {
                      "type": "string"
                    },
                    "input": {
                      "type": "string"
                    },
                    "use_case": {
                      "type": "string"
                    },
                    "operation": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "supported_domains": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_bulk_jobs",
          "description": "List the user's bulk extraction jobs with their progress: operation, domain, status, total/completed/failed/invalid item counts, and timestamps. This reads the SAME data as the Bulk Requests page in the Easyparser web app, so it can see and track jobs the user started from the app UI, not just jobs submitted through this MCP server.\n\nUse this tool when the user asks about their bulk jobs: \"is my job done?\", \"what bulk jobs are running?\", \"did the DETAIL batch finish?\". Each row includes a group_id: pass it to get_bulk_job_items to drill into individual items, or to get_bulk_webhook_logs to check webhook deliveries.\n\nStatuses: pending (queued), processing (running), completed (all items succeeded), partial_success (some items failed or were dropped; check failed_items/invalid_items counts), failed. This tool is free of per-call credits (monitoring endpoints do not consume credits).",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "page": {
                "type": "integer",
                "default": 1,
                "minimum": 1,
                "description": "Page number. Default 1."
              },
              "limit": {
                "type": "integer",
                "default": 100,
                "maximum": 1000,
                "minimum": 1,
                "description": "Items per page (max 1000). Default 100."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "description": "Filter by marketplace domain."
              },
              "status": {
                "enum": [
                  "pending",
                  "processing",
                  "completed",
                  "partial_success",
                  "failed"
                ],
                "type": "string",
                "description": "Filter by job status: pending, processing, completed, partial_success (some items failed), failed."
              },
              "operation": {
                "enum": [
                  "DETAIL",
                  "OFFER",
                  "SEARCH",
                  "PRODUCT_LOOKUP",
                  "SALES_ANALYSIS_HISTORY",
                  "BEST_SELLERS_RANK",
                  "PACKAGE_DIMENSION",
                  "SELLER_PROFILE",
                  "SELLER_PRODUCTS",
                  "SELLER_FEEDBACK"
                ],
                "type": "string",
                "description": "Filter by operation type, e.g. DETAIL or SEARCH."
              },
              "sort_direction": {
                "enum": [
                  "asc",
                  "desc"
                ],
                "type": "string",
                "default": "desc",
                "description": "Sort by creation time. 'desc' (newest first) is default."
              },
              "bulk_request_id": {
                "type": "string",
                "description": "Look up a specific job by its bulk_request_id (returned when the job was submitted)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "description": "JSON response from the Easyparser Data Service or Account API. Non-object payloads are wrapped as { result }.",
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_bulk_job_items",
          "description": "Inspect the individual items inside a bulk job: each item's input value (ASIN, keyword, seller ID...), its status (success/failed/invalid/pending/processing), error message if it failed, credit cost, and completion time.\n\nUse this tool to debug a job after list_bulk_jobs shows failed_items or invalid_items > 0: filter with status='failed' or status='invalid' to see exactly which inputs failed and why. Use search_key to locate one specific ASIN inside a large job. The item's item_id can be used with the Data Service (GET /v1/queries/{id}) to fetch its parsed result.\n\nThis tool is free of per-call credits (monitoring endpoints do not consume credits).",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "group_id"
            ],
            "properties": {
              "page": {
                "type": "integer",
                "default": 1,
                "minimum": 1,
                "description": "Page number. Default 1."
              },
              "limit": {
                "type": "integer",
                "default": 100,
                "maximum": 1000,
                "minimum": 1,
                "description": "Items per page (max 1000). Default 100."
              },
              "status": {
                "enum": [
                  "success",
                  "invalid",
                  "failed",
                  "accepted",
                  "pending",
                  "processing"
                ],
                "type": "string",
                "description": "Filter items by outcome. Use 'failed' or 'invalid' to debug a partial_success job; omit to see everything."
              },
              "date_to": {
                "type": "string",
                "description": "ISO date upper bound."
              },
              "group_id": {
                "type": "string",
                "description": "The job's group_id. Get it from list_bulk_jobs (each job row has one). Identifies which job's items to inspect."
              },
              "date_from": {
                "type": "string",
                "description": "ISO date lower bound, e.g. 2026-08-01."
              },
              "search_key": {
                "type": "string",
                "description": "Search within item values (e.g. a specific ASIN) to find one item in a large job."
              },
              "sort_direction": {
                "enum": [
                  "asc",
                  "desc"
                ],
                "type": "string",
                "default": "desc",
                "description": "Sort by creation time. 'desc' (newest first) is default."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "description": "JSON response from the Easyparser Data Service or Account API. Non-object payloads are wrapped as { result }.",
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_bulk_item_result",
          "description": "Fetch the parsed result data of a single bulk job item: the actual Amazon data that item produced (product detail, search results, seller profile, etc., depending on the job's operation). This is the same data shown in the item result modal on the Bulk Requests page of the web app.\n\nUse this tool after get_bulk_job_items, when the user wants to see the DATA behind a specific item, not just its status. Typical flow: list_bulk_jobs → get_bulk_job_items → get_bulk_item_result.\n\nIMPORTANT: bulk results are retained for 24 HOURS after the job completes, then they expire. If the item's data has expired, the tool returns a clear message; suggest re-running that item through the matching real-time tool (e.g. get_product_detail for a DETAIL item) to regenerate the data. This tool is free of per-call credits.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "item_id"
            ],
            "properties": {
              "item_id": {
                "type": "string",
                "description": "The item_id of a bulk job item. Get it from get_bulk_job_items (each item row has one). This is the same ID the Data Service calls a query ID."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "description": "JSON response from the Easyparser Data Service or Account API. Non-object payloads are wrapped as { result }.",
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_bulk_webhook_logs",
          "description": "Check webhook delivery logs for bulk jobs: whether the completion notification was delivered to the user's callback_url, delivery status, and timestamps. Use this when a job shows as completed but the user's system never received the webhook. This is the classic \"job finished but my integration didn't fire\" debugging case.\n\nScope to one job with group_id (from list_bulk_jobs), or omit it to scan recent deliveries across all jobs. This tool is free of per-call credits.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "page": {
                "type": "integer",
                "default": 1,
                "minimum": 1,
                "description": "Page number. Default 1."
              },
              "limit": {
                "type": "integer",
                "default": 100,
                "maximum": 1000,
                "minimum": 1,
                "description": "Items per page (max 1000). Default 100."
              },
              "status": {
                "type": "string",
                "description": "Filter by delivery status (e.g. 'success', 'failed')."
              },
              "date_to": {
                "type": "string",
                "description": "ISO date upper bound."
              },
              "group_id": {
                "type": "string",
                "description": "Scope logs to one job's group_id. Omit to see recent webhook deliveries across all jobs."
              },
              "date_from": {
                "type": "string",
                "description": "ISO date lower bound."
              },
              "request_id": {
                "type": "string",
                "description": "Filter by an individual request ID."
              },
              "sort_direction": {
                "enum": [
                  "asc",
                  "desc"
                ],
                "type": "string",
                "default": "desc",
                "description": "Sort by creation time. 'desc' (newest first) is default."
              },
              "bulk_request_id": {
                "type": "string",
                "description": "Filter by the job's bulk_request_id."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "description": "JSON response from the Easyparser Data Service or Account API. Non-object payloads are wrapped as { result }.",
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_error_logs",
          "description": "List the user's API request error logs: the same data shown on the Errors page of the Easyparser web app. Covers both real-time API errors and bulk job errors: each row has the platform, operation, domain, error code, channel (BULK/REALTIME), the request parameters that caused it, and a timestamp.\n\nUse this tool when the user asks about failures: \"why are my requests failing?\", \"show me recent errors\", \"any webhook errors today?\", \"what went wrong with my DETAIL calls?\". Filter by error_channel (BULK or REALTIME), error_code, operation, or domain to narrow down. Each row includes a request_id and the query_params that triggered the error, so you can trace exactly which input failed.\n\nThis tool is free of per-call credits (monitoring endpoints do not consume credits).",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "page": {
                "type": "integer",
                "default": 1,
                "minimum": 1,
                "description": "Page number. Default 1."
              },
              "limit": {
                "type": "integer",
                "default": 100,
                "maximum": 1000,
                "minimum": 1,
                "description": "Items per page (max 1000). Default 100."
              },
              "domain": {
                "enum": [
                  ".com",
                  ".co.uk",
                  ".de",
                  ".fr",
                  ".it",
                  ".es",
                  ".ca",
                  ".com.mx",
                  ".com.br",
                  ".co.jp",
                  ".in",
                  ".com.au",
                  ".ae",
                  ".sa",
                  ".nl",
                  ".pl",
                  ".se",
                  ".com.be",
                  ".com.tr",
                  ".sg",
                  ".ie",
                  ".eg"
                ],
                "type": "string",
                "description": "Filter by marketplace domain."
              },
              "date_to": {
                "type": "string",
                "description": "ISO date upper bound."
              },
              "order_by": {
                "enum": [
                  "create_date",
                  "error_channel",
                  "error_code",
                  "platform",
                  "domain",
                  "operation"
                ],
                "type": "string",
                "default": "create_date",
                "description": "Sort field. Default 'create_date'."
              },
              "platform": {
                "type": "string",
                "description": "Filter by platform (e.g. 'AMZ')."
              },
              "date_from": {
                "type": "string",
                "description": "ISO date lower bound, e.g. 2026-08-01."
              },
              "operation": {
                "enum": [
                  "DETAIL",
                  "OFFER",
                  "SEARCH",
                  "PRODUCT_LOOKUP",
                  "SALES_ANALYSIS_HISTORY",
                  "BEST_SELLERS_RANK",
                  "PACKAGE_DIMENSION",
                  "SELLER_PROFILE",
                  "SELLER_PRODUCTS",
                  "SELLER_FEEDBACK"
                ],
                "type": "string",
                "description": "Filter by operation type, e.g. DETAIL or SEARCH."
              },
              "error_code": {
                "type": "string",
                "description": "Filter by a specific error code, e.g. 'WEBHOOK_ERROR_404' or 'SOMETHING_WENT_WRONG'."
              },
              "order_type": {
                "enum": [
                  "asc",
                  "desc"
                ],
                "type": "string",
                "default": "desc",
                "description": "Sort direction. 'desc' (newest first) is default."
              },
              "error_channel": {
                "enum": [
                  "BULK",
                  "REALTIME"
                ],
                "type": "string",
                "description": "Filter by channel: BULK (bulk job errors) or REALTIME (real-time API errors). Omit for both."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "description": "JSON response from the Easyparser Data Service or Account API. Non-object payloads are wrapped as { result }.",
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "check_credits",
          "description": "Check the Easyparser account: current plan, credit balance (used/remaining/limit), credit reset date, per-minute rate limits, and this month's daily usage breakdown by operation. FREE: this calls the Account API and consumes no credits.\n\nUse this before running expensive multi-page or 12-month-history jobs, when the user asks about their quota or plan, or to analyze usage patterns (e.g. 'which operation consumed the most credits this month?'). Requires an API key.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "description": "JSON response from the Easyparser Data Service or Account API. Non-object payloads are wrapped as { result }.",
            "additionalProperties": true
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "operations",
          "uri": "easyparser://operations",
          "mimeType": "application/json",
          "description": "Every Easyparser operation with its tool name, input, credit cost and use case. Free to read."
        },
        {
          "name": "marketplaces",
          "uri": "easyparser://marketplaces",
          "mimeType": "application/json",
          "description": "The 22 Amazon marketplace domains Easyparser supports, for the domain parameter of every data tool."
        },
        {
          "name": "usage-guide",
          "uri": "easyparser://guide",
          "mimeType": "text/markdown",
          "description": "Decision rules for picking the right tool and keeping credit usage low."
        }
      ],
      "prompts": [
        {
          "name": "analyze_competitor_product",
          "description": "Full competitive teardown of one Amazon product: listing details, who sells it and at what price, and recent sales and BSR trends.",
          "arguments": [
            {
              "name": "asin",
              "required": true,
              "description": "ASIN of the product to analyze, e.g. B0CJB6V2L5"
            },
            {
              "name": "domain",
              "required": false,
              "description": "Amazon marketplace domain, e.g. .com, .de, .co.uk. Defaults to .com. Supported: .com, .co.uk, .de, .fr, .it, .es, .ca, .com.mx, .com.br, .co.jp, .in, .com.au, .ae, .sa, .nl, .pl, .se, .com.be, .com.tr, .sg, .ie, .eg"
            }
          ]
        },
        {
          "name": "estimate_fba_logistics",
          "description": "Get exact package dimensions, weight and Amazon fee category for a product to plan FBA fees and shipping.",
          "arguments": [
            {
              "name": "asin",
              "required": true,
              "description": "ASIN of the product, e.g. B0CJB6V2L5"
            },
            {
              "name": "domain",
              "required": false,
              "description": "Amazon marketplace domain, e.g. .com, .de, .co.uk. Defaults to .com. Supported: .com, .co.uk, .de, .fr, .it, .es, .ca, .com.mx, .com.br, .co.jp, .in, .com.au, .ae, .sa, .nl, .pl, .se, .com.be, .com.tr, .sg, .ie, .eg"
            }
          ]
        },
        {
          "name": "match_barcodes_to_asins",
          "description": "Convert a list of UPC, EAN, GTIN or ISBN codes into Amazon ASINs with a product snapshot for each.",
          "arguments": [
            {
              "name": "codes",
              "required": true,
              "description": "Comma- or newline-separated barcodes"
            },
            {
              "name": "identifier_type",
              "required": false,
              "description": "UPC, EAN, GTIN, ISBN, JAN or MINSAN. Inferred from length if omitted."
            },
            {
              "name": "domain",
              "required": false,
              "description": "Amazon marketplace domain, e.g. .com, .de, .co.uk. Defaults to .com. Supported: .com, .co.uk, .de, .fr, .it, .es, .ca, .com.mx, .com.br, .co.jp, .in, .com.au, .ae, .sa, .nl, .pl, .se, .com.be, .com.tr, .sg, .ie, .eg"
            }
          ]
        },
        {
          "name": "vet_amazon_seller",
          "description": "Check a seller's legal identity, reputation trends and recent negative feedback before partnering or sourcing.",
          "arguments": [
            {
              "name": "seller_id",
              "required": true,
              "description": "Amazon seller ID, e.g. A1MCYUGJD2ILFU"
            },
            {
              "name": "domain",
              "required": false,
              "description": "Amazon marketplace domain, e.g. .com, .de, .co.uk. Defaults to .com. Supported: .com, .co.uk, .de, .fr, .it, .es, .ca, .com.mx, .com.br, .co.jp, .in, .com.au, .ae, .sa, .nl, .pl, .se, .com.be, .com.tr, .sg, .ie, .eg"
            }
          ]
        },
        {
          "name": "product_market_research",
          "description": "Scan an Amazon search niche: top products, price range, ratings and badges, then drill into the leaders.",
          "arguments": [
            {
              "name": "keyword",
              "required": true,
              "description": "Search keyword, e.g. 'standing desk'"
            },
            {
              "name": "domain",
              "required": false,
              "description": "Amazon marketplace domain, e.g. .com, .de, .co.uk. Defaults to .com. Supported: .com, .co.uk, .de, .fr, .it, .es, .ca, .com.mx, .com.br, .co.jp, .in, .com.au, .ae, .sa, .nl, .pl, .se, .com.be, .com.tr, .sg, .ie, .eg"
            }
          ]
        }
      ]
    },
    "instructions": "Easyparser gives you real-time, structured Amazon data across 22 marketplaces: product details, seller offers, search results, sales history, seller identities, and logistics data.\n\nDecision rules:\n1. ASIN or product URL in hand → call the specific tool directly, never search first.\n2. Only a barcode (UPC/EAN/GTIN/ISBN) → lookup_product to get the ASIN, then the specific tool.\n3. Only a product name or category → search_products to find ASINs, then drill down.\n4. Cost awareness: most tools cost 1 credit. get_sales_history costs 5+ credits, so confirm the history depth with the user before calling. Paginated tools cost 1 credit per page, so prefer filters over extra pages.\n5. Every response includes credits_remaining. If it drops low or a call returns a rate-limit error, tell the user to get a free key at https://app.easyparser.com/signup.\n6. If unsure which tool fits, call list_operations: it is free and works without a key.\n7. Bulk jobs: use list_bulk_jobs to see the user's bulk extraction jobs (including ones started from the Easyparser web app), get_bulk_job_items to debug failed items inside a job, get_bulk_item_result to fetch an item's parsed data (results expire; regenerate via the matching real-time tool if expired), and get_bulk_webhook_logs when a completed job's webhook never arrived. These monitoring tools are free."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}