{
  "openapi": "3.1.0",
  "info": {
    "title": "Nexscope Ecommerce Data, SEO, and Creative APIs",
    "version": "2026-08-28-public-catalog-v1",
    "description": "Nexscope APIs provide ecommerce marketplace intelligence, SEO research, and creative generation capabilities through REST and MCP. Authentication uses a Nexscope API key. Pricing is credit-based and actual usage varies by endpoint and workload; current estimates are shown in the Nexscope account.",
    "termsOfService": "https://www.nexscope.ai/terms",
    "contact": {
      "name": "Nexscope Support",
      "email": "service@nexscope.ai",
      "url": "https://www.nexscope.ai/api-docs"
    },
    "license": {
      "name": "Proprietary API; use subject to Nexscope Terms",
      "url": "https://www.nexscope.ai/terms"
    }
  },
  "externalDocs": {
    "description": "Nexscope API Documentation",
    "url": "https://www.nexscope.ai/api-docs"
  },
  "servers": [
    {
      "url": "https://api.nexscope.ai",
      "description": "Production"
    }
  ],
  "tags": [
    {
      "name": "Amazon Marketplace Intelligence",
      "description": "Amazon product, search, market, review, traffic and policy APIs.",
      "x-category-slug": "amazon-marketplace-intelligence"
    },
    {
      "name": "Keyword & Search Demand",
      "description": "Keyword expansion, search volume, share of voice and ranking intelligence.",
      "x-category-slug": "keyword-search-demand"
    },
    {
      "name": "TikTok / Social Commerce",
      "description": "TikTok Shop products, sellers, videos, creators, livestreams and rankings.",
      "x-category-slug": "tiktok-social-commerce"
    },
    {
      "name": "Temu Marketplace Intelligence",
      "description": "Temu product, category and store source APIs.",
      "x-category-slug": "temu-marketplace"
    },
    {
      "name": "1688 Sourcing",
      "description": "1688 product search, image search and billboard sourcing APIs.",
      "x-category-slug": "1688-sourcing"
    },
    {
      "name": "Shopify Commerce",
      "description": "Shopify product and store query APIs.",
      "x-category-slug": "shopify-commerce"
    },
    {
      "name": "Etsy Marketplace",
      "description": "Etsy product and category discovery APIs.",
      "x-category-slug": "etsy-marketplace"
    },
    {
      "name": "Ozon Marketplace",
      "description": "Ozon product, category, shop, seller and keyword APIs.",
      "x-category-slug": "ozon-marketplace"
    },
    {
      "name": "eBay Marketplace",
      "description": "eBay marketplace product search APIs.",
      "x-category-slug": "ebay-marketplace"
    },
    {
      "name": "Shopee Marketplace",
      "description": "Shopee product search APIs.",
      "x-category-slug": "shopee-marketplace"
    },
    {
      "name": "Search & Trend Intelligence",
      "description": "Google Trends, AI mode search and web search APIs.",
      "x-category-slug": "search-trend-intelligence"
    },
    {
      "name": "Image Generation Models",
      "description": "Dedicated image generation APIs with one fixed model per endpoint.",
      "x-category-slug": "image-generation-models"
    },
    {
      "name": "Video Generation Models",
      "description": "Dedicated video generation APIs with one fixed model per endpoint.",
      "x-category-slug": "video-generation-models"
    },
    {
      "name": "Multimodal AI",
      "description": "Image recognition, image editing, image generation, and ecommerce creative APIs.",
      "x-category-slug": "multimodal-ai"
    },
    {
      "name": "Patent & IP Risk",
      "description": "Patent, trademark, copyright and IP risk APIs.",
      "x-category-slug": "patent-ip-risk"
    },
    {
      "name": "Product & Market Research",
      "description": "General ecommerce product and market research APIs.",
      "x-category-slug": "product-market-research"
    },
    {
      "name": "Amazon Advertising",
      "description": "Amazon advertising access, reporting and campaign intelligence APIs.",
      "x-category-slug": "amazon-advertising"
    },
    {
      "name": "Patent Intelligence",
      "description": "Patent search and intellectual-property research APIs.",
      "x-category-slug": "patent-intelligence"
    },
    {
      "name": "Ecommerce Content Generation",
      "description": "Product description and product video generation APIs.",
      "x-category-slug": "ecommerce-content-generation"
    },
    {
      "name": "Keywords & Trends",
      "description": "Keyword demand, search volume, and trend research APIs.",
      "x-category-slug": "keywords-trends"
    },
    {
      "name": "Search Results & Rankings",
      "description": "Search result, ranking, and SERP research APIs.",
      "x-category-slug": "search-results-rankings"
    },
    {
      "name": "Competitors & Traffic",
      "description": "Competitor and website traffic research APIs.",
      "x-category-slug": "competitors-traffic"
    },
    {
      "name": "Pages & Websites",
      "description": "Website, page, and technical SEO analysis APIs.",
      "x-category-slug": "pages-websites"
    },
    {
      "name": "AI Search & Citations",
      "description": "AI search visibility, mentions, and citation research APIs.",
      "x-category-slug": "ai-search-citations"
    },
    {
      "name": "Backlinks & Authority",
      "description": "Backlink profile and authority research APIs.",
      "x-category-slug": "backlinks-authority"
    },
    {
      "name": "Advertising Intelligence",
      "description": "Advertiser, audience, and advertising research APIs.",
      "x-category-slug": "advertising-intelligence"
    }
  ],
  "paths": {
    "/api/skill-api/v1/skills/amazon-ads-sp-insights-report-download/run": {
      "post": {
        "tags": [
          "Amazon Advertising"
        ],
        "summary": "Amazon Ads SP Insights Report Download",
        "description": "Uses existing Amazon Ads authorization and tokenized download handling. Create once, poll by reportId, then download using a documentToken.",
        "operationId": "runAmazonAdsSpInsightsReportDownload",
        "externalDocs": {
          "description": "Amazon Ads SP Insights Report Download documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-ads-sp-insights-report-download"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "connectionId",
                  "documentToken"
                ],
                "additionalProperties": false,
                "properties": {
                  "connectionId": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "documentToken": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "type": "object"
              },
              "example": {
                "connectionId": 123,
                "documentToken": "opaque-document-token"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "contentType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Downloaded media type",
                                  "example": "text/csv"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "content": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "UTF-8 CSV report content",
                                  "example": "date.value,metric.impressions\n2026-08-01,10\n"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "content": "date.value,metric.impressions\n2026-08-01,10\n",
                    "contentType": "text/csv"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-ads-sp-insights-report-download",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_ads_sp_insights_report_download",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-ads-sp-insights-report-status/run": {
      "post": {
        "tags": [
          "Amazon Advertising"
        ],
        "summary": "Amazon Ads SP Insights Report Status",
        "description": "Uses existing Amazon Ads authorization and tokenized download handling. Create once, poll by reportId, then download using a documentToken.",
        "operationId": "runAmazonAdsSpInsightsReportStatus",
        "externalDocs": {
          "description": "Amazon Ads SP Insights Report Status documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-ads-sp-insights-report-status"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "connectionId",
                  "reportId"
                ],
                "additionalProperties": false,
                "properties": {
                  "connectionId": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "reportId": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "type": "object"
              },
              "example": {
                "connectionId": 123,
                "reportId": "report-id"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "reportId": {
                              "type": "string",
                              "description": "Created or queried report identifier.",
                              "example": "report-id"
                            },
                            "status": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider report state when present.",
                                  "example": "PENDING"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "completedReportParts": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Completed CSV parts; each part contains a backend documentToken instead of a signed URL.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "reportParts": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Provider alias for completed parts, when present.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "reportId"
                          ],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reportId": "report-id",
                    "status": "PENDING"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-ads-sp-insights-report-status",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_ads_sp_insights_report_status",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-ads-sp-search-impression-share-report/run": {
      "post": {
        "tags": [
          "Amazon Advertising"
        ],
        "summary": "Amazon Ads SP Search Impression Share Report",
        "description": "Uses existing Amazon Ads authorization and tokenized download handling. Create once, poll by reportId, then download using a documentToken.",
        "operationId": "runAmazonAdsSpSearchImpressionShareReport",
        "externalDocs": {
          "description": "Amazon Ads SP Search Impression Share Report documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-ads-sp-search-impression-share-report"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "connectionId",
                  "startDate",
                  "endDate"
                ],
                "additionalProperties": false,
                "properties": {
                  "connectionId": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "startDate": {
                    "format": "date",
                    "type": "string"
                  },
                  "endDate": {
                    "format": "date",
                    "type": "string"
                  },
                  "advertiserAccountId": {
                    "type": "string",
                    "minLength": 1
                  },
                  "timeUnit": {
                    "enum": [
                      "DAILY",
                      "SUMMARY"
                    ],
                    "default": "DAILY",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "example": {
                "connectionId": 123,
                "startDate": "2026-08-01",
                "endDate": "2026-08-07"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "reportId": {
                              "type": "string",
                              "description": "Created or queried report identifier.",
                              "example": "report-id"
                            },
                            "status": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider report state when present.",
                                  "example": "PENDING"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "completedReportParts": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Completed CSV parts; each part contains a backend documentToken instead of a signed URL.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "reportParts": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Provider alias for completed parts, when present.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "reportId"
                          ],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reportId": "report-id",
                    "status": "PENDING"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-ads-sp-search-impression-share-report",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_ads_sp_search_impression_share_report",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-ads-sp-audience-report/run": {
      "post": {
        "tags": [
          "Amazon Advertising"
        ],
        "summary": "Amazon Ads SP Audience Report",
        "description": "Uses existing Amazon Ads authorization and tokenized download handling. Create once, poll by reportId, then download using a documentToken.",
        "operationId": "runAmazonAdsSpAudienceReport",
        "externalDocs": {
          "description": "Amazon Ads SP Audience Report documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-ads-sp-audience-report"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "connectionId",
                  "startDate",
                  "endDate"
                ],
                "additionalProperties": false,
                "properties": {
                  "connectionId": {
                    "minimum": 1,
                    "type": "integer"
                  },
                  "startDate": {
                    "format": "date",
                    "type": "string"
                  },
                  "endDate": {
                    "format": "date",
                    "type": "string"
                  },
                  "advertiserAccountId": {
                    "type": "string",
                    "minLength": 1
                  },
                  "timeUnit": {
                    "enum": [
                      "DAILY",
                      "SUMMARY"
                    ],
                    "default": "DAILY",
                    "type": "string"
                  },
                  "detailLevel": {
                    "enum": [
                      "ACCOUNT",
                      "CAMPAIGN",
                      "AD_GROUP"
                    ],
                    "default": "ACCOUNT",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "example": {
                "connectionId": 123,
                "startDate": "2026-08-01",
                "endDate": "2026-08-07"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "reportId": {
                              "type": "string",
                              "description": "Created or queried report identifier.",
                              "example": "report-id"
                            },
                            "status": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider report state when present.",
                                  "example": "PENDING"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "completedReportParts": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Completed CSV parts; each part contains a backend documentToken instead of a signed URL.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "reportParts": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Provider alias for completed parts, when present.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "reportId"
                          ],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reportId": "report-id",
                    "status": "PENDING"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-ads-sp-audience-report",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_ads_sp_audience_report",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creative-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creative Detail",
        "description": "TikTok Creative Detail. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokCreativeDetail",
        "externalDocs": {
          "description": "Nexscope TikTok Creative Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creative-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country",
                  "id"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "id": {
                    "minLength": 1,
                    "type": "string",
                    "description": "Creative ID returned by its search operation. Keep identifiers as strings to avoid precision loss."
                  },
                  "include": {
                    "pattern": "^(analysis|embedding)(,(analysis|embedding))*$",
                    "type": "string",
                    "description": "Comma-separated expansions: analysis, embedding. Request only needed expansions."
                  }
                },
                "type": "object"
              },
              "example": {
                "include": "analysis,embedding",
                "country": "us",
                "id": "7668708053428047118"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Creative author and product identity: id.",
                                            "type": "string"
                                          },
                                          "video_id": {
                                            "nullable": true,
                                            "description": "Creative author and product identity: video id.",
                                            "type": "string"
                                          },
                                          "uid": {
                                            "nullable": true,
                                            "description": "Creative author and product identity: uid.",
                                            "type": "string"
                                          },
                                          "unique_id": {
                                            "nullable": true,
                                            "description": "Creative author and product identity: unique id.",
                                            "type": "string"
                                          },
                                          "nickname": {
                                            "nullable": true,
                                            "description": "Creative author and product identity: nickname.",
                                            "type": "string"
                                          },
                                          "share_url": {
                                            "nullable": true,
                                            "description": "Creative author and product identity: share url.",
                                            "type": "string"
                                          },
                                          "product_id": {
                                            "nullable": true,
                                            "description": "Creative author and product identity: product id.",
                                            "type": "string"
                                          },
                                          "product_name": {
                                            "nullable": true,
                                            "description": "Creative author and product identity: product name.",
                                            "type": "string"
                                          },
                                          "follower_count": {
                                            "nullable": true,
                                            "description": "Author follower count: follower count.",
                                            "type": "integer"
                                          },
                                          "product_sold_count": {
                                            "description": "Provider product sales count."
                                          },
                                          "ceiling_price": {
                                            "description": "Provider upper product price; preserve its currency object and runtime type."
                                          },
                                          "video_share_count": {
                                            "description": "Provider video share count."
                                          },
                                          "video_30d_gpm": {
                                            "description": "Provider 30-day video GPM; preserve its original unit and runtime type."
                                          },
                                          "video_comment_count": {
                                            "description": "Provider video comment count."
                                          },
                                          "product_rating": {
                                            "description": "Provider product rating."
                                          },
                                          "floor_price": {
                                            "description": "Provider lower product price; preserve its currency object and runtime type."
                                          },
                                          "video_engagement_rate": {
                                            "description": "Provider video engagement rate."
                                          },
                                          "product_l1_category": {
                                            "description": "First-level product category."
                                          },
                                          "product_l2_category": {
                                            "description": "Second-level product category."
                                          },
                                          "commission_rate": {
                                            "description": "Provider commission rate."
                                          },
                                          "product_l3_category": {
                                            "description": "Third-level product category."
                                          },
                                          "product_images": {
                                            "description": "Provider product images. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "video_30d_gmv": {
                                            "description": "Provider 30-day video GMV; preserve its original unit and runtime type."
                                          },
                                          "video_play_count": {
                                            "description": "Provider video play count."
                                          },
                                          "product_status": {
                                            "description": "Provider product status."
                                          },
                                          "video_like_count": {
                                            "description": "Provider video like count."
                                          },
                                          "video_collect_count": {
                                            "description": "Provider video collect count."
                                          },
                                          "product_gmv": {
                                            "description": "Provider product GMV; preserve its original unit and runtime type."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "analysis": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: id."
                                              },
                                              "video_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: video id."
                                              },
                                              "video_uri": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: video uri."
                                              },
                                              "country_code": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: country code."
                                              },
                                              "platform": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: platform."
                                              },
                                              "hook_type": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: hook type."
                                              },
                                              "hook_subtype": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: hook subtype."
                                              },
                                              "formula_type": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: formula type."
                                              },
                                              "formula_subtype": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: formula subtype."
                                              },
                                              "angle_type": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: angle type."
                                              },
                                              "angle_subtype": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative analysis identifier or classification: angle subtype."
                                              },
                                              "is_aigc_video": {
                                                "type": "boolean",
                                                "nullable": true,
                                                "description": "Provider AIGC flag: is aigc video."
                                              },
                                              "video_cover": {
                                                "description": "Creative video cover media; preserve the provider representation."
                                              },
                                              "transcription_with_structure": {
                                                "description": "Creative transcription with provider structural annotations; preserve its original JSON representation."
                                              },
                                              "storyboards": {
                                                "description": "Creative storyboard and scene analysis; preserve the returned structure."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "type": "array"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "type": "object",
                                  "nullable": true
                                },
                                "embedding": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative embedding identity: id."
                                              },
                                              "video_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative embedding identity: video id."
                                              },
                                              "video_uri": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative embedding identity: video uri."
                                              },
                                              "country_code": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative embedding identity: country code."
                                              },
                                              "platform": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Creative embedding identity: platform."
                                              },
                                              "embedding": {
                                                "type": "array",
                                                "nullable": true,
                                                "description": "Numeric embedding vector; returned only when requested. Avoid inlining the vector in summaries.",
                                                "items": {
                                                  "type": "number"
                                                }
                                              },
                                              "matched_tags": {
                                                "description": "Tags matched during creative embedding analysis; preserve the provider representation."
                                              },
                                              "extracted_content": {
                                                "description": "Content extracted for creative similarity analysis; preserve the provider representation."
                                              },
                                              "video_cover": {
                                                "description": "Creative video cover media; preserve the provider representation."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "type": "array"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "type": "object",
                                  "nullable": true
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": []
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creative-detail",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creative_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creative-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creative Search",
        "description": "TikTok Creative Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokCreativeSearch",
        "externalDocs": {
          "description": "Nexscope TikTok Creative Search documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creative-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "page": {
                    "minimum": 1,
                    "default": 1,
                    "type": "integer",
                    "description": "Page number, starting at 1. No automatic pagination."
                  },
                  "pageSize": {
                    "minimum": 1,
                    "maximum": 10,
                    "type": "integer",
                    "description": "Items per page, from 1 to 10. Omission preserves the upstream default."
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Creative search keyword."
                  },
                  "category": {
                    "type": "string",
                    "description": "Provider-approved creative category."
                  },
                  "hasProduct": {
                    "type": "boolean",
                    "description": "Whether products are associated."
                  },
                  "isSponsored": {
                    "type": "boolean",
                    "description": "Whether content is sponsored."
                  },
                  "isAigc": {
                    "type": "boolean",
                    "description": "Whether content is generated by AI."
                  },
                  "sort": {
                    "default": "gmv:desc",
                    "pattern": "^[^:]+:(asc|desc)$",
                    "type": "string",
                    "description": "Provider-approved field followed by :asc or :desc. No complete field enum is published."
                  }
                },
                "type": "object"
              },
              "example": {
                "page": 1,
                "pageSize": 3,
                "country": "us"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Creative identity and copy: id.",
                                            "type": "string"
                                          },
                                          "video_id": {
                                            "nullable": true,
                                            "description": "Creative identity and copy: video id.",
                                            "type": "string"
                                          },
                                          "product_id": {
                                            "nullable": true,
                                            "description": "Creative identity and copy: product id.",
                                            "type": "string"
                                          },
                                          "author_uid": {
                                            "nullable": true,
                                            "description": "Creative identity and copy: author uid.",
                                            "type": "string"
                                          },
                                          "author_unique_id": {
                                            "nullable": true,
                                            "description": "Creative identity and copy: author unique id.",
                                            "type": "string"
                                          },
                                          "author_nickname": {
                                            "nullable": true,
                                            "description": "Creative identity and copy: author nickname.",
                                            "type": "string"
                                          },
                                          "video_desc": {
                                            "nullable": true,
                                            "description": "Creative identity and copy: video desc.",
                                            "type": "string"
                                          },
                                          "country_code": {
                                            "nullable": true,
                                            "description": "Creative identity and copy: country code.",
                                            "type": "string"
                                          },
                                          "platform": {
                                            "nullable": true,
                                            "description": "Creative identity and copy: platform.",
                                            "type": "string"
                                          },
                                          "follower_cnt": {
                                            "nullable": true,
                                            "description": "Creative audience and engagement count: follower cnt.",
                                            "type": "integer"
                                          },
                                          "video_play_count": {
                                            "nullable": true,
                                            "description": "Creative audience and engagement count: video play count.",
                                            "type": "integer"
                                          },
                                          "video_like_count": {
                                            "nullable": true,
                                            "description": "Creative audience and engagement count: video like count.",
                                            "type": "integer"
                                          },
                                          "video_comment_count": {
                                            "nullable": true,
                                            "description": "Creative audience and engagement count: video comment count.",
                                            "type": "integer"
                                          },
                                          "video_share_count": {
                                            "nullable": true,
                                            "description": "Creative audience and engagement count: video share count.",
                                            "type": "integer"
                                          },
                                          "video_collect_count": {
                                            "nullable": true,
                                            "description": "Creative audience and engagement count: video collect count.",
                                            "type": "integer"
                                          },
                                          "video_engagement_rate": {
                                            "nullable": true,
                                            "description": "Provider engagement ratio: video engagement rate.",
                                            "type": "number"
                                          },
                                          "video_30d_gmv": {
                                            "nullable": true,
                                            "description": "Monetary metric with original unit and value: video 30d gmv.",
                                            "type": "object"
                                          },
                                          "video_total_gmv": {
                                            "nullable": true,
                                            "description": "Monetary metric with original unit and value: video total gmv.",
                                            "type": "object"
                                          },
                                          "video_30d_gpm": {
                                            "nullable": true,
                                            "description": "Monetary metric with original unit and value: video 30d gpm.",
                                            "type": "object"
                                          },
                                          "content_intent": {
                                            "description": "Provider content intent. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "user_avatar": {
                                            "description": "Provider user avatar. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "is_aigc_video": {
                                            "description": "Provider is aigc video. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "content_tag_v2": {
                                            "description": "Provider content tag v2. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "video_launch_time": {
                                            "description": "Provider video launch time. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "video_date": {
                                            "description": "Provider video date. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "video_duration": {
                                            "description": "Provider video duration. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [],
                      "total_count": 0
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creative-search",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creative_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-ad-related-products/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Ad Related Products",
        "description": "TikTok Ad Related Products. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokAdRelatedProducts",
        "externalDocs": {
          "description": "Nexscope TikTok Ad Related Products documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-ad-related-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country",
                  "id"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "id": {
                    "minLength": 1,
                    "type": "string",
                    "description": "Ad ID returned by its search operation. Keep identifiers as strings to avoid precision loss."
                  },
                  "page": {
                    "minimum": 1,
                    "default": 1,
                    "type": "integer",
                    "description": "Page number, starting at 1. No automatic pagination."
                  },
                  "pageSize": {
                    "minimum": 1,
                    "maximum": 10,
                    "type": "integer",
                    "description": "Items per page, from 1 to 10. Omission preserves the upstream default."
                  }
                },
                "type": "object"
              },
              "example": {
                "pageSize": 3,
                "page": 1,
                "country": "us",
                "id": "7658119807128046879"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Related product identity: id.",
                                            "type": "string"
                                          },
                                          "tiktok_product_detail_product_name": {
                                            "nullable": true,
                                            "description": "Related product identity: tiktok product detail product name.",
                                            "type": "string"
                                          },
                                          "tiktok_product_detail_floor_price": {
                                            "nullable": true,
                                            "description": "Price with original unit and value: tiktok product detail floor price.",
                                            "type": "object"
                                          },
                                          "tiktok_product_detail_ceiling_price": {
                                            "nullable": true,
                                            "description": "Price with original unit and value: tiktok product detail ceiling price.",
                                            "type": "object"
                                          },
                                          "tiktok_product_detail_product_rating": {
                                            "nullable": true,
                                            "description": "Provider product rating: tiktok product detail product rating.",
                                            "type": "number"
                                          },
                                          "tiktok_ads_detail_product_id": {
                                            "nullable": true,
                                            "description": "Ad related product identity: tiktok ads detail product id.",
                                            "type": "string"
                                          },
                                          "tiktok_ads_detail_video_id": {
                                            "nullable": true,
                                            "description": "Ad related product identity: tiktok ads detail video id.",
                                            "type": "string"
                                          },
                                          "tiktok_ads_detail_product_country_code": {
                                            "nullable": true,
                                            "description": "Ad related product identity: tiktok ads detail product country code.",
                                            "type": "string"
                                          },
                                          "tiktok_ads_detail_product_total_sold_count": {
                                            "nullable": true,
                                            "description": "Ad attributed sales count: tiktok ads detail product total sold count.",
                                            "type": "integer"
                                          },
                                          "tiktok_ads_detail_video_30d_sold_count": {
                                            "nullable": true,
                                            "description": "Ad attributed sales count: tiktok ads detail video 30d sold count.",
                                            "type": "integer"
                                          },
                                          "tiktok_ads_detail_product_total_gmv": {
                                            "nullable": true,
                                            "description": "GMV preserving original unit and value: tiktok ads detail product total gmv.",
                                            "type": "object"
                                          },
                                          "tiktok_ads_detail_video_30d_gmv": {
                                            "nullable": true,
                                            "description": "GMV preserving original unit and value: tiktok ads detail video 30d gmv.",
                                            "type": "object"
                                          },
                                          "tiktok_ads_detail_product_launch_time": {
                                            "description": "Provider tiktok ads detail product launch time. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_l3_category": {
                                            "description": "Provider tiktok product detail l3 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_product_images": {
                                            "description": "Provider tiktok product detail product images. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_product_sku_props": {
                                            "description": "Provider tiktok product detail product sku props. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_region": {
                                            "description": "Provider tiktok product detail region. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_product_skus": {
                                            "description": "Provider tiktok product detail product skus. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_commission_rate": {
                                            "description": "Provider tiktok product detail commission rate. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_l1_category": {
                                            "description": "Provider tiktok product detail l1 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_product_status": {
                                            "description": "Provider tiktok product detail product status. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_l2_category": {
                                            "description": "Provider tiktok product detail l2 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [],
                      "total_count": 0
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-ad-related-products",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_ad_related_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-ad-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Ad Detail",
        "description": "TikTok Ad Detail. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokAdDetail",
        "externalDocs": {
          "description": "Nexscope TikTok Ad Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-ad-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country",
                  "id"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "id": {
                    "minLength": 1,
                    "type": "string",
                    "description": "Ad ID returned by its search operation. Keep identifiers as strings to avoid precision loss."
                  },
                  "include": {
                    "pattern": "^(core)(,(core))*$",
                    "type": "string",
                    "description": "Comma-separated expansions: core. Request only needed expansions."
                  }
                },
                "type": "object"
              },
              "example": {
                "include": "core",
                "country": "us",
                "id": "7658119807128046879"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: id.",
                                            "type": "string"
                                          },
                                          "ad_title": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: ad title.",
                                            "type": "string"
                                          },
                                          "advertiser_id": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: advertiser id.",
                                            "type": "string"
                                          },
                                          "advertiser_name": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: advertiser name.",
                                            "type": "string"
                                          },
                                          "ad_url": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: ad url.",
                                            "type": "string"
                                          },
                                          "web_url": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: web url.",
                                            "type": "string"
                                          },
                                          "button_text": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: button text.",
                                            "type": "string"
                                          },
                                          "advertiser_avatar": {
                                            "nullable": true,
                                            "description": "Provider image object: advertiser avatar.",
                                            "type": "object"
                                          },
                                          "ad_cover": {
                                            "nullable": true,
                                            "description": "Provider image object: ad cover.",
                                            "type": "object"
                                          },
                                          "duration": {
                                            "nullable": true,
                                            "description": "Provider time or duration; preserve original units: duration.",
                                            "type": "integer"
                                          },
                                          "ad_create_time": {
                                            "nullable": true,
                                            "description": "Provider time or duration; preserve original units: ad create time.",
                                            "type": "integer"
                                          },
                                          "create_time": {
                                            "nullable": true,
                                            "description": "Provider time or duration; preserve original units: create time.",
                                            "type": "integer"
                                          },
                                          "last_update_time": {
                                            "nullable": true,
                                            "description": "Provider time or duration; preserve original units: last update time.",
                                            "type": "integer"
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "core": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Core ad identity or provider ad type: id."
                                              },
                                              "core_creative_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Core ad identity or provider ad type: core creative id."
                                              },
                                              "core_ad_type": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Core ad identity or provider ad type: core ad type."
                                              },
                                              "core_ad_day_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core ad performance count: core ad day count."
                                              },
                                              "core_total_sc": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core ad performance count: core total sc."
                                              },
                                              "core_video_play_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core ad performance count: core video play count."
                                              },
                                              "core_video_like_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core ad performance count: core video like count."
                                              },
                                              "core_video_comment_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core ad performance count: core video comment count."
                                              },
                                              "core_video_share_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core ad performance count: core video share count."
                                              },
                                              "core_video_collect_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core ad performance count: core video collect count."
                                              },
                                              "core_ad_play_ratio": {
                                                "type": "number",
                                                "nullable": true,
                                                "description": "Provider ratio or score; preserve original metric definition: core ad play ratio."
                                              },
                                              "core_ad_gmv_ratio": {
                                                "type": "number",
                                                "nullable": true,
                                                "description": "Provider ratio or score; preserve original metric definition: core ad gmv ratio."
                                              },
                                              "core_ad_roas": {
                                                "type": "number",
                                                "nullable": true,
                                                "description": "Provider ratio or score; preserve original metric definition: core ad roas."
                                              },
                                              "core_video_popularity": {
                                                "type": "number",
                                                "nullable": true,
                                                "description": "Provider ratio or score; preserve original metric definition: core video popularity."
                                              },
                                              "core_ad_maximum_cost": {
                                                "type": "object",
                                                "nullable": true,
                                                "description": "Provider monetary metric; preserve original unit and value: core ad maximum cost."
                                              },
                                              "core_total_gmv": {
                                                "type": "object",
                                                "nullable": true,
                                                "description": "Provider monetary metric; preserve original unit and value: core total gmv."
                                              },
                                              "core_video_gpm_30d": {
                                                "type": "object",
                                                "nullable": true,
                                                "description": "Provider monetary metric; preserve original unit and value: core video gpm 30d."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "type": "array"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "type": "object",
                                  "nullable": true
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": []
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-ad-detail",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_ad_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-ad-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Ad Search",
        "description": "TikTok Ad Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokAdSearch",
        "externalDocs": {
          "description": "Nexscope TikTok Ad Search documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-ad-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "page": {
                    "minimum": 1,
                    "default": 1,
                    "type": "integer",
                    "description": "Page number, starting at 1. No automatic pagination."
                  },
                  "pageSize": {
                    "minimum": 1,
                    "maximum": 10,
                    "type": "integer",
                    "description": "Items per page, from 1 to 10. Omission preserves the upstream default."
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Ad search keyword."
                  },
                  "category": {
                    "type": "string",
                    "description": "Provider-approved product category."
                  },
                  "adType": {
                    "type": "string",
                    "description": "Provider-approved ad type value; no enum is published."
                  },
                  "excludeSparkAds": {
                    "type": "boolean",
                    "description": "Whether to exclude Spark Ads."
                  },
                  "minViews": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxViews": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "minGmv": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxGmv": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "minDays": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxDays": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "sort": {
                    "default": "gmv:desc",
                    "pattern": "^[^:]+:(asc|desc)$",
                    "type": "string",
                    "description": "Provider-approved field followed by :asc or :desc. No complete field enum is published."
                  }
                },
                "type": "object"
              },
              "example": {
                "page": 1,
                "pageSize": 3,
                "country": "us"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: id.",
                                            "type": "string"
                                          },
                                          "video_id": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: video id.",
                                            "type": "string"
                                          },
                                          "product_id": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: product id.",
                                            "type": "string"
                                          },
                                          "advertiser_id": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: advertiser id.",
                                            "type": "string"
                                          },
                                          "ad_url": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: ad url.",
                                            "type": "string"
                                          },
                                          "web_url": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: web url.",
                                            "type": "string"
                                          },
                                          "advertiser_url": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: advertiser url.",
                                            "type": "string"
                                          },
                                          "ad_title": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: ad title.",
                                            "type": "string"
                                          },
                                          "advertiser_name": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: advertiser name.",
                                            "type": "string"
                                          },
                                          "button_text": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: button text.",
                                            "type": "string"
                                          },
                                          "product_title": {
                                            "nullable": true,
                                            "description": "Ad identity and copy: product title.",
                                            "type": "string"
                                          },
                                          "video_play_count": {
                                            "nullable": true,
                                            "description": "Ad delivery count: video play count.",
                                            "type": "integer"
                                          },
                                          "video_like_count": {
                                            "nullable": true,
                                            "description": "Ad delivery count: video like count.",
                                            "type": "integer"
                                          },
                                          "ad_day_count": {
                                            "nullable": true,
                                            "description": "Ad delivery count: ad day count.",
                                            "type": "integer"
                                          },
                                          "video_like_rate": {
                                            "nullable": true,
                                            "description": "Provider engagement ratio: video like rate.",
                                            "type": "number"
                                          },
                                          "video_engagement_rate": {
                                            "nullable": true,
                                            "description": "Provider engagement ratio: video engagement rate.",
                                            "type": "number"
                                          },
                                          "total_gmv": {
                                            "nullable": true,
                                            "description": "Monetary metric with original unit and value: total gmv.",
                                            "type": "object"
                                          },
                                          "video_gpm_30d": {
                                            "nullable": true,
                                            "description": "Monetary metric with original unit and value: video gpm 30d.",
                                            "type": "object"
                                          },
                                          "ad_create_time": {
                                            "description": "Provider ad create time. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "total_sc": {
                                            "description": "Provider total sc. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "last_update_time": {
                                            "description": "Provider last update time. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "video_popularity": {
                                            "description": "Provider video popularity. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "ad_roas": {
                                            "description": "Provider return on ad spend; preserve the runtime JSON type and metric definition."
                                          },
                                          "duration": {
                                            "description": "Provider duration. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "create_time": {
                                            "description": "Provider create time. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "product_l1_category": {
                                            "description": "Provider product l1 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "product_l2_category": {
                                            "description": "Provider product l2 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "product_l3_category": {
                                            "description": "Provider product l3 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "ad_maximum_cost": {
                                            "description": "Maximum ad spend as returned; preserve monetary units and the runtime JSON type."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [],
                      "total_count": 0
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-ad-search",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_ad_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-video-reviews/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Video Reviews",
        "description": "TikTok Video Reviews. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokVideoReviews",
        "externalDocs": {
          "description": "Nexscope TikTok Video Reviews documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-video-reviews"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country",
                  "id"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "id": {
                    "minLength": 1,
                    "type": "string",
                    "description": "Video ID returned by its search operation. Keep identifiers as strings to avoid precision loss."
                  },
                  "page": {
                    "minimum": 1,
                    "default": 1,
                    "type": "integer",
                    "description": "Page number, starting at 1. No automatic pagination."
                  },
                  "pageSize": {
                    "minimum": 1,
                    "maximum": 10,
                    "type": "integer",
                    "description": "Items per page, from 1 to 10. Omission preserves the upstream default."
                  }
                },
                "type": "object"
              },
              "example": {
                "pageSize": 3,
                "page": 1,
                "country": "us",
                "id": "6788833646091504902"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "tiktok_video_detail_comment_id": {
                                            "nullable": true,
                                            "description": "Comment identity and text: tiktok video detail comment id.",
                                            "type": "string"
                                          },
                                          "tiktok_video_detail_comment_text": {
                                            "nullable": true,
                                            "description": "Comment identity and text: tiktok video detail comment text.",
                                            "type": "string"
                                          },
                                          "tiktok_video_detail_comment_unique_id": {
                                            "nullable": true,
                                            "description": "Comment identity and text: tiktok video detail comment unique id.",
                                            "type": "string"
                                          },
                                          "tiktok_video_detail_comment_nickname": {
                                            "nullable": true,
                                            "description": "Comment identity and text: tiktok video detail comment nickname.",
                                            "type": "string"
                                          },
                                          "tiktok_video_detail_video_id": {
                                            "nullable": true,
                                            "description": "Comment identity and text: tiktok video detail video id.",
                                            "type": "string"
                                          },
                                          "tiktok_video_detail_comment_create_time": {
                                            "nullable": true,
                                            "description": "Provider comment timestamp or count; preserve original units: tiktok video detail comment create time.",
                                            "type": "integer"
                                          },
                                          "tiktok_video_detail_comment_like_count": {
                                            "nullable": true,
                                            "description": "Provider comment timestamp or count; preserve original units: tiktok video detail comment like count.",
                                            "type": "integer"
                                          },
                                          "tiktok_video_detail_comment_reply_count": {
                                            "nullable": true,
                                            "description": "Provider comment timestamp or count; preserve original units: tiktok video detail comment reply count.",
                                            "type": "integer"
                                          },
                                          "tiktok_video_detail_comment_user_avatar": {
                                            "nullable": true,
                                            "description": "Avatar object with thumb_url and url: tiktok video detail comment user avatar.",
                                            "type": "object"
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [],
                      "total_count": 0
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-video-reviews",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_video_reviews",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-video-related-products/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Video Related Products",
        "description": "TikTok Video Related Products. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokVideoRelatedProducts",
        "externalDocs": {
          "description": "Nexscope TikTok Video Related Products documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-video-related-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country",
                  "id"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "id": {
                    "minLength": 1,
                    "type": "string",
                    "description": "Video ID returned by its search operation. Keep identifiers as strings to avoid precision loss."
                  },
                  "page": {
                    "minimum": 1,
                    "default": 1,
                    "type": "integer",
                    "description": "Page number, starting at 1. No automatic pagination."
                  },
                  "pageSize": {
                    "minimum": 1,
                    "maximum": 10,
                    "type": "integer",
                    "description": "Items per page, from 1 to 10. Omission preserves the upstream default."
                  }
                },
                "type": "object"
              },
              "example": {
                "pageSize": 3,
                "page": 1,
                "country": "us",
                "id": "7672655263672864013"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Related product identity: id.",
                                            "type": "string"
                                          },
                                          "tiktok_product_detail_product_name": {
                                            "nullable": true,
                                            "description": "Related product identity: tiktok product detail product name.",
                                            "type": "string"
                                          },
                                          "tiktok_product_detail_floor_price": {
                                            "nullable": true,
                                            "description": "Price with original unit and value: tiktok product detail floor price.",
                                            "type": "object"
                                          },
                                          "tiktok_product_detail_ceiling_price": {
                                            "nullable": true,
                                            "description": "Price with original unit and value: tiktok product detail ceiling price.",
                                            "type": "object"
                                          },
                                          "tiktok_product_detail_product_rating": {
                                            "nullable": true,
                                            "description": "Provider product rating: tiktok product detail product rating.",
                                            "type": "number"
                                          },
                                          "tiktok_video_detail_product_id": {
                                            "nullable": true,
                                            "description": "Product and video identifier: tiktok video detail product id.",
                                            "type": "string"
                                          },
                                          "tiktok_video_detail_video_id": {
                                            "nullable": true,
                                            "description": "Product and video identifier: tiktok video detail video id.",
                                            "type": "string"
                                          },
                                          "tiktok_video_detail_product_total_sold_count": {
                                            "nullable": true,
                                            "description": "Video attributed sales count: tiktok video detail product total sold count.",
                                            "type": "integer"
                                          },
                                          "tiktok_video_detail_video_30d_sold_count": {
                                            "nullable": true,
                                            "description": "Video attributed sales count: tiktok video detail video 30d sold count.",
                                            "type": "integer"
                                          },
                                          "tiktok_video_detail_product_total_gmv": {
                                            "nullable": true,
                                            "description": "GMV with original unit and value: tiktok video detail product total gmv.",
                                            "type": "object"
                                          },
                                          "tiktok_video_detail_video_30d_gmv": {
                                            "nullable": true,
                                            "description": "GMV with original unit and value: tiktok video detail video 30d gmv.",
                                            "type": "object"
                                          },
                                          "tiktok_product_detail_product_sku_props": {
                                            "description": "Provider tiktok product detail product sku props. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_product_images": {
                                            "description": "Provider tiktok product detail product images. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_l1_category": {
                                            "description": "Provider tiktok product detail l1 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_product_skus": {
                                            "description": "Provider tiktok product detail product skus. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_l2_category": {
                                            "description": "Provider tiktok product detail l2 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_l3_category": {
                                            "description": "Provider tiktok product detail l3 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_product_status": {
                                            "description": "Provider tiktok product detail product status. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_product_detail_commission_rate": {
                                            "description": "Provider tiktok product detail commission rate. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [],
                      "total_count": 0
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-video-related-products",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_video_related_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-video-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Video Detail",
        "description": "TikTok Video Detail. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokVideoDetail",
        "externalDocs": {
          "description": "Nexscope TikTok Video Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-video-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country",
                  "id"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "id": {
                    "minLength": 1,
                    "type": "string",
                    "description": "Video ID returned by its search operation. Keep identifiers as strings to avoid precision loss."
                  },
                  "include": {
                    "pattern": "^(core)(,(core))*$",
                    "type": "string",
                    "description": "Comma-separated expansions: core. Request only needed expansions."
                  }
                },
                "type": "object"
              },
              "example": {
                "include": "core",
                "country": "us",
                "id": "6788833646091504902"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Video detail identity: id.",
                                            "type": "string"
                                          },
                                          "unique_id": {
                                            "nullable": true,
                                            "description": "Video detail identity: unique id.",
                                            "type": "string"
                                          },
                                          "nickname": {
                                            "nullable": true,
                                            "description": "Video detail identity: nickname.",
                                            "type": "string"
                                          },
                                          "share_url": {
                                            "nullable": true,
                                            "description": "Video detail identity: share url.",
                                            "type": "string"
                                          },
                                          "video_cover": {
                                            "nullable": true,
                                            "description": "Provider image object: video cover.",
                                            "type": "object"
                                          },
                                          "user_avatar": {
                                            "nullable": true,
                                            "description": "Provider image object: user avatar.",
                                            "type": "object"
                                          },
                                          "video_duration": {
                                            "nullable": true,
                                            "description": "Provider duration or author count; preserve original units: video duration.",
                                            "type": "integer"
                                          },
                                          "follower_count": {
                                            "nullable": true,
                                            "description": "Provider duration or author count; preserve original units: follower count.",
                                            "type": "integer"
                                          },
                                          "video_count": {
                                            "nullable": true,
                                            "description": "Provider duration or author count; preserve original units: video count.",
                                            "type": "integer"
                                          },
                                          "video_avg_play_count": {
                                            "nullable": true,
                                            "description": "Author historical average metric: video avg play count.",
                                            "type": "number"
                                          },
                                          "video_avg_like_count": {
                                            "nullable": true,
                                            "description": "Author historical average metric: video avg like count.",
                                            "type": "number"
                                          },
                                          "author_avg_engagement_rate": {
                                            "nullable": true,
                                            "description": "Author historical average metric: author avg engagement rate.",
                                            "type": "number"
                                          },
                                          "had_product": {
                                            "nullable": true,
                                            "description": "Provider content flag: had product.",
                                            "type": "boolean"
                                          },
                                          "has_comment": {
                                            "nullable": true,
                                            "description": "Provider content flag: has comment.",
                                            "type": "boolean"
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "core": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "core_country_code": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Country of the returned video: core country code."
                                              },
                                              "core_video_play_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core video engagement count: core video play count."
                                              },
                                              "core_video_like_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core video engagement count: core video like count."
                                              },
                                              "core_video_comment_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core video engagement count: core video comment count."
                                              },
                                              "core_video_share_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core video engagement count: core video share count."
                                              },
                                              "core_video_collect_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core video engagement count: core video collect count."
                                              },
                                              "core_video_engagement_rate": {
                                                "type": "number",
                                                "nullable": true,
                                                "description": "Core video decimal ratio: core video engagement rate."
                                              },
                                              "core_video_like_play_ratio": {
                                                "type": "number",
                                                "nullable": true,
                                                "description": "Core video decimal ratio: core video like play ratio."
                                              },
                                              "core_video_30d_gpm": {
                                                "type": "object",
                                                "nullable": true,
                                                "description": "Thirty-day GPM with original unit and value: core video 30d gpm."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "type": "array"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "type": "object",
                                  "nullable": true
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": []
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-video-detail",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_video_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-video-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Video Keyword Search",
        "description": "TikTok Video Keyword Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokVideoSearch",
        "externalDocs": {
          "description": "Nexscope TikTok Video Search documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-video-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "page": {
                    "minimum": 1,
                    "default": 1,
                    "type": "integer",
                    "description": "Page number, starting at 1. No automatic pagination."
                  },
                  "pageSize": {
                    "minimum": 1,
                    "maximum": 10,
                    "type": "integer",
                    "description": "Items per page, from 1 to 10. Omission preserves the upstream default."
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Video copy or related keyword."
                  },
                  "category": {
                    "type": "string",
                    "description": "Use only provider-approved categories; no category enum is published."
                  },
                  "isCommercial": {
                    "type": "boolean",
                    "description": "Filter videos promoting products."
                  },
                  "minViews": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxViews": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "minLikes": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxLikes": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "minGmv30d": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxGmv30d": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "minEngagement": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxEngagement": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "accountType": {
                    "enum": [
                      0,
                      3,
                      4
                    ],
                    "type": "integer",
                    "description": "Provider account type; business labels are unpublished."
                  },
                  "sort": {
                    "default": "views:desc",
                    "pattern": "^[^:]+:(asc|desc)$",
                    "type": "string",
                    "description": "Provider-approved field followed by :asc or :desc. No complete field enum is published."
                  }
                },
                "type": "object"
              },
              "example": {
                "page": 1,
                "pageSize": 3,
                "country": "us"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Video identity: id.",
                                            "type": "string"
                                          },
                                          "video_desc": {
                                            "nullable": true,
                                            "description": "Video identity: video desc.",
                                            "type": "string"
                                          },
                                          "share_url": {
                                            "nullable": true,
                                            "description": "Video identity: share url.",
                                            "type": "string"
                                          },
                                          "author_id": {
                                            "nullable": true,
                                            "description": "Video identity: author id.",
                                            "type": "string"
                                          },
                                          "author_unique_id": {
                                            "nullable": true,
                                            "description": "Video identity: author unique id.",
                                            "type": "string"
                                          },
                                          "author_nickname": {
                                            "nullable": true,
                                            "description": "Video identity: author nickname.",
                                            "type": "string"
                                          },
                                          "country_code": {
                                            "nullable": true,
                                            "description": "Video identity: country code.",
                                            "type": "string"
                                          },
                                          "video_play_count": {
                                            "nullable": true,
                                            "description": "Engagement count: video play count.",
                                            "type": "integer"
                                          },
                                          "video_like_count": {
                                            "nullable": true,
                                            "description": "Engagement count: video like count.",
                                            "type": "integer"
                                          },
                                          "video_comment_count": {
                                            "nullable": true,
                                            "description": "Engagement count: video comment count.",
                                            "type": "integer"
                                          },
                                          "video_share_count": {
                                            "nullable": true,
                                            "description": "Engagement count: video share count.",
                                            "type": "integer"
                                          },
                                          "video_collect_count": {
                                            "nullable": true,
                                            "description": "Engagement count: video collect count.",
                                            "type": "integer"
                                          },
                                          "video_engagement_rate": {
                                            "nullable": true,
                                            "description": "Decimal engagement ratio: video engagement rate.",
                                            "type": "number"
                                          },
                                          "video_launch_time": {
                                            "nullable": true,
                                            "description": "Provider video metadata: video launch time.",
                                            "type": "integer"
                                          },
                                          "video_duration": {
                                            "nullable": true,
                                            "description": "Provider video metadata: video duration.",
                                            "type": "integer"
                                          },
                                          "account_type": {
                                            "nullable": true,
                                            "description": "Provider video metadata: account type.",
                                            "type": "integer"
                                          },
                                          "video_30d_gpm": {
                                            "nullable": true,
                                            "description": "Thirty-day GPM with original unit and value: video 30d gpm.",
                                            "type": "object"
                                          },
                                          "is_ad": {
                                            "nullable": true,
                                            "description": "Optional provider flag: is ad.",
                                            "type": "boolean"
                                          },
                                          "is_aigc_video": {
                                            "nullable": true,
                                            "description": "Optional provider flag: is aigc video.",
                                            "type": "boolean"
                                          },
                                          "video_total_like_count_to_follower_count_ratio": {
                                            "description": "Provider video total like count to follower count ratio. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [],
                      "total_count": 0
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-video-search",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_video_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-live-related-products/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Live Related Products",
        "description": "TikTok Live Related Products. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokLiveRelatedProducts",
        "externalDocs": {
          "description": "Nexscope TikTok Live Related Products documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-live-related-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country",
                  "id"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "id": {
                    "minLength": 1,
                    "type": "string",
                    "description": "Livestream ID returned by its search operation. Keep identifiers as strings to avoid precision loss."
                  },
                  "page": {
                    "minimum": 1,
                    "default": 1,
                    "type": "integer",
                    "description": "Page number, starting at 1. No automatic pagination."
                  },
                  "pageSize": {
                    "minimum": 1,
                    "maximum": 10,
                    "type": "integer",
                    "description": "Items per page, from 1 to 10. Omission preserves the upstream default."
                  }
                },
                "type": "object"
              },
              "example": {
                "pageSize": 3,
                "page": 1,
                "country": "us",
                "id": "7643101948819835678"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Livestream product identity: id.",
                                            "type": "string"
                                          },
                                          "tiktok_live_detail_product_id": {
                                            "nullable": true,
                                            "description": "Livestream product identity: tiktok live detail product id.",
                                            "type": "string"
                                          },
                                          "tiktok_live_detail_product_title": {
                                            "nullable": true,
                                            "description": "Livestream product identity: tiktok live detail product title.",
                                            "type": "string"
                                          },
                                          "tiktok_live_detail_product_country_code": {
                                            "nullable": true,
                                            "description": "Livestream product identity: tiktok live detail product country code.",
                                            "type": "string"
                                          },
                                          "tiktok_live_detail_product_seller_id": {
                                            "nullable": true,
                                            "description": "Livestream product identity: tiktok live detail product seller id.",
                                            "type": "string"
                                          },
                                          "tiktok_live_detail_product_seller_name": {
                                            "nullable": true,
                                            "description": "Livestream product identity: tiktok live detail product seller name.",
                                            "type": "string"
                                          },
                                          "tiktok_live_detail_product_floor_price": {
                                            "nullable": true,
                                            "description": "Monetary metric with original unit and value: tiktok live detail product floor price.",
                                            "type": "object"
                                          },
                                          "tiktok_live_detail_product_ceiling_price": {
                                            "nullable": true,
                                            "description": "Monetary metric with original unit and value: tiktok live detail product ceiling price.",
                                            "type": "object"
                                          },
                                          "tiktok_live_detail_product_gmv": {
                                            "nullable": true,
                                            "description": "Monetary metric with original unit and value: tiktok live detail product gmv.",
                                            "type": "object"
                                          },
                                          "tiktok_live_detail_product_images": {
                                            "nullable": true,
                                            "description": "Image with url and thumb_url: tiktok live detail product images.",
                                            "type": "object"
                                          },
                                          "tiktok_live_detail_product_seller_avatar": {
                                            "nullable": true,
                                            "description": "Image with url and thumb_url: tiktok live detail product seller avatar.",
                                            "type": "object"
                                          },
                                          "tiktok_live_detail_product_sold_count": {
                                            "nullable": true,
                                            "description": "Livestream attributed sold units: tiktok live detail product sold count.",
                                            "type": "integer"
                                          },
                                          "tiktok_live_detail_product_commission_rate_num": {
                                            "nullable": true,
                                            "description": "Decimal ratio, which may be absent: tiktok live detail product commission rate num.",
                                            "type": "number"
                                          },
                                          "tiktok_live_detail_product_conversion_rate": {
                                            "nullable": true,
                                            "description": "Decimal ratio, which may be absent: tiktok live detail product conversion rate.",
                                            "type": "number"
                                          },
                                          "tiktok_live_detail_product_l3_category": {
                                            "description": "Provider tiktok live detail product l3 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_live_detail_product_l1_category": {
                                            "description": "Provider tiktok live detail product l1 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_live_detail_product_seller_category_name_label": {
                                            "description": "Provider tiktok live detail product seller category name label. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_live_detail_product_l2_category": {
                                            "description": "Provider tiktok live detail product l2 category. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          },
                                          "tiktok_live_detail_product_seller_info": {
                                            "description": "Provider tiktok live detail product seller info. The source establishes this field name; preserve its runtime JSON type and missing values."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [],
                      "total_count": 0
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-live-related-products",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_live_related_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-live-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Live Detail",
        "description": "TikTok Live Detail. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokLiveDetail",
        "externalDocs": {
          "description": "Nexscope TikTok Live Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-live-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country",
                  "id"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "id": {
                    "minLength": 1,
                    "type": "string",
                    "description": "Livestream ID returned by its search operation. Keep identifiers as strings to avoid precision loss."
                  },
                  "include": {
                    "pattern": "^(core)(,(core))*$",
                    "type": "string",
                    "description": "Comma-separated expansions: core. Request only needed expansions."
                  }
                },
                "type": "object"
              },
              "example": {
                "include": "core",
                "country": "us",
                "id": "7643101948819835678"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Livestream identity: id.",
                                            "type": "string"
                                          },
                                          "title": {
                                            "nullable": true,
                                            "description": "Livestream identity: title.",
                                            "type": "string"
                                          },
                                          "room_link": {
                                            "nullable": true,
                                            "description": "Livestream identity: room link.",
                                            "type": "string"
                                          },
                                          "user_id": {
                                            "nullable": true,
                                            "description": "Livestream identity: user id.",
                                            "type": "string"
                                          },
                                          "user_nickname": {
                                            "nullable": true,
                                            "description": "Livestream identity: user nickname.",
                                            "type": "string"
                                          },
                                          "country_code": {
                                            "nullable": true,
                                            "description": "Livestream identity: country code.",
                                            "type": "string"
                                          },
                                          "most_product_category_label": {
                                            "nullable": true,
                                            "description": "Livestream identity: most product category label.",
                                            "type": "string"
                                          },
                                          "start_time": {
                                            "nullable": true,
                                            "description": "Unix timestamp in milliseconds: start time.",
                                            "type": "integer"
                                          },
                                          "end_time": {
                                            "nullable": true,
                                            "description": "Unix timestamp in milliseconds: end time.",
                                            "type": "integer"
                                          },
                                          "cover": {
                                            "nullable": true,
                                            "description": "Image object with url and thumb_url: cover.",
                                            "type": "object"
                                          },
                                          "user_avatar": {
                                            "nullable": true,
                                            "description": "Host avatar with url and thumb_url: user avatar.",
                                            "type": "object"
                                          },
                                          "user_follower_count": {
                                            "nullable": true,
                                            "description": "Host historical count: user follower count.",
                                            "type": "integer"
                                          },
                                          "user_live_count": {
                                            "nullable": true,
                                            "description": "Host historical count: user live count.",
                                            "type": "integer"
                                          },
                                          "user_avg_audience_count": {
                                            "nullable": true,
                                            "description": "Host historical average audience: user avg audience count.",
                                            "type": "number"
                                          },
                                          "user_avg_max_audience_count": {
                                            "nullable": true,
                                            "description": "Host historical average audience: user avg max audience count.",
                                            "type": "number"
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "core": {
                                  "additionalProperties": true,
                                  "properties": {
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Core livestream identifier: id."
                                              },
                                              "core_room_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Core livestream identifier: core room id."
                                              },
                                              "core_country_code": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Core livestream identifier: core country code."
                                              },
                                              "core_gmv": {
                                                "type": "object",
                                                "nullable": true,
                                                "description": "Monetary metric with original unit and value: core gmv."
                                              },
                                              "core_gpm": {
                                                "type": "object",
                                                "nullable": true,
                                                "description": "Monetary metric with original unit and value: core gpm."
                                              },
                                              "core_avg_price": {
                                                "type": "object",
                                                "nullable": true,
                                                "description": "Monetary metric with original unit and value: core avg price."
                                              },
                                              "core_product_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core livestream performance count: core product count."
                                              },
                                              "core_sold_product_id_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core livestream performance count: core sold product id count."
                                              },
                                              "core_total_sold_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core livestream performance count: core total sold count."
                                              },
                                              "core_total_user": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core livestream performance count: core total user."
                                              },
                                              "core_max_user_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core livestream performance count: core max user count."
                                              },
                                              "core_new_follow_count": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Core livestream performance count: core new follow count."
                                              },
                                              "core_avg_online_viewer": {
                                                "type": "number",
                                                "nullable": true,
                                                "description": "Average online audience: core avg online viewer."
                                              },
                                              "core_follower_conversion_rate": {
                                                "type": "number",
                                                "nullable": true,
                                                "description": "Decimal follower conversion ratio: core follower conversion rate."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "type": "array"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "type": "object",
                                  "nullable": true
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": []
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-live-detail",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_live_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-live-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Live Search",
        "description": "TikTok Live Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.",
        "operationId": "runChuhaijiangTiktokLiveSearch",
        "externalDocs": {
          "description": "Nexscope TikTok Live Search documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-live-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "country"
                ],
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "type": "string",
                    "description": "Lowercase request market. Returned country_code may differ; preserve both."
                  },
                  "page": {
                    "minimum": 1,
                    "default": 1,
                    "type": "integer",
                    "description": "Page number, starting at 1. No automatic pagination."
                  },
                  "pageSize": {
                    "minimum": 1,
                    "maximum": 10,
                    "type": "integer",
                    "description": "Items per page, from 1 to 10. Omission preserves the upstream default."
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Livestream keyword."
                  },
                  "category": {
                    "type": "string",
                    "description": "Provider-approved livestream category; no enum is published."
                  },
                  "productCategory": {
                    "type": "string",
                    "description": "Provider-approved product category."
                  },
                  "isLiving": {
                    "type": "boolean",
                    "description": "Filter currently live rooms."
                  },
                  "isCommercial": {
                    "type": "boolean",
                    "description": "Filter rooms promoting products."
                  },
                  "minSold": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxSold": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "minGmv": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxGmv": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "minAudience": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "maxAudience": {
                    "type": "number",
                    "description": "Provider filter value; retain the provider metric definition without unit conversion."
                  },
                  "sort": {
                    "default": "gmv:desc",
                    "pattern": "^[^:]+:(asc|desc)$",
                    "type": "string",
                    "description": "Provider-approved field followed by :asc or :desc. No complete field enum is published."
                  }
                },
                "type": "object"
              },
              "example": {
                "page": 1,
                "pageSize": 3,
                "country": "us"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": "object",
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "nullable": true,
                                            "description": "Livestream identity: id.",
                                            "type": "string"
                                          },
                                          "title": {
                                            "nullable": true,
                                            "description": "Livestream identity: title.",
                                            "type": "string"
                                          },
                                          "room_link": {
                                            "nullable": true,
                                            "description": "Livestream identity: room link.",
                                            "type": "string"
                                          },
                                          "user_id": {
                                            "nullable": true,
                                            "description": "Livestream identity: user id.",
                                            "type": "string"
                                          },
                                          "user_nickname": {
                                            "nullable": true,
                                            "description": "Livestream identity: user nickname.",
                                            "type": "string"
                                          },
                                          "country_code": {
                                            "nullable": true,
                                            "description": "Livestream identity: country code.",
                                            "type": "string"
                                          },
                                          "most_product_category_label": {
                                            "nullable": true,
                                            "description": "Livestream identity: most product category label.",
                                            "type": "string"
                                          },
                                          "start_time": {
                                            "nullable": true,
                                            "description": "Unix timestamp in milliseconds: start time.",
                                            "type": "integer"
                                          },
                                          "end_time": {
                                            "nullable": true,
                                            "description": "Unix timestamp in milliseconds: end time.",
                                            "type": "integer"
                                          },
                                          "cover": {
                                            "nullable": true,
                                            "description": "Image object with url and thumb_url: cover.",
                                            "type": "object"
                                          },
                                          "user_unique_id": {
                                            "nullable": true,
                                            "description": "Host identity: user unique id.",
                                            "type": "string"
                                          },
                                          "user_category_label": {
                                            "nullable": true,
                                            "description": "Host identity: user category label.",
                                            "type": "string"
                                          },
                                          "product_count": {
                                            "nullable": true,
                                            "description": "Livestream performance count: product count.",
                                            "type": "integer"
                                          },
                                          "total_sold_count": {
                                            "nullable": true,
                                            "description": "Livestream performance count: total sold count.",
                                            "type": "integer"
                                          },
                                          "total_user": {
                                            "nullable": true,
                                            "description": "Livestream performance count: total user.",
                                            "type": "integer"
                                          },
                                          "max_user_count": {
                                            "nullable": true,
                                            "description": "Livestream performance count: max user count.",
                                            "type": "integer"
                                          },
                                          "new_follow_count": {
                                            "nullable": true,
                                            "description": "Livestream performance count: new follow count.",
                                            "type": "integer"
                                          },
                                          "gmv": {
                                            "nullable": true,
                                            "description": "Monetary metric preserving original unit and value: gmv.",
                                            "type": "object"
                                          },
                                          "gpm": {
                                            "nullable": true,
                                            "description": "Monetary metric preserving original unit and value: gpm.",
                                            "type": "object"
                                          },
                                          "opm": {
                                            "nullable": true,
                                            "description": "Orders per thousand viewers: opm.",
                                            "type": "number"
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "nullable": true,
                                      "type": "integer"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [],
                      "total_count": 0
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-live-search",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_live_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-rankings-growth/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creator Growth",
        "description": "Provider business records for TikTok Creator Growth. Known row fields: bio_email, category_label, channel_id, creator_oecuid, follower_count, handle, id, interval_new_follower, nickname, tioktok_creator_growth_interval_new_follower_ratio, uid, unique_id, user_avatar, user_sell_product_l1_category, video_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokCreatorRankingsGrowth",
        "externalDocs": {
          "description": "Nexscope TikTok Creator Growth documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-rankings-growth"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 20,
                    "example": 5
                  },
                  "date": {
                    "type": "string",
                    "description": "Ranking date in YYYYMMDD format.",
                    "pattern": "^[0-9]{8}$",
                    "example": "20260824"
                  },
                  "granularity": {
                    "type": "string",
                    "description": "Ranking period.",
                    "enum": [
                      "daily",
                      "weekly",
                      "monthly",
                      "0",
                      "1",
                      "2"
                    ],
                    "example": "daily"
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "new_follower_count:desc",
                    "pattern": "^[A-Za-z0-9_]+:(asc|desc)$",
                    "example": "new_follower_count:desc"
                  },
                  "creatorCategory": {
                    "type": "string",
                    "description": "Creator category."
                  },
                  "productCategory": {
                    "type": "string",
                    "description": "Product category."
                  }
                },
                "required": [
                  "country",
                  "date",
                  "granularity"
                ]
              },
              "example": {
                "country": "us",
                "pageSize": 10,
                "date": "20260828",
                "granularity": "daily"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "bio_email": {
                                            "description": "Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "category_label": {
                                            "description": "Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "channel_id": {
                                            "description": "Source-documented channel_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "creator_oecuid": {
                                            "description": "Source-documented creator_oecuid; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "follower_count": {
                                            "description": "Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "handle": {
                                            "description": "Source-documented handle; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_new_follower": {
                                            "description": "Source-documented interval_new_follower; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "nickname": {
                                            "description": "Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tioktok_creator_growth_interval_new_follower_ratio": {
                                            "description": "Source-documented tioktok_creator_growth_interval_new_follower_ratio; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "uid": {
                                            "description": "Source-documented uid; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "unique_id": {
                                            "description": "Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_avatar": {
                                            "description": "Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_sell_product_l1_category": {
                                            "description": "Source-documented user_sell_product_l1_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_count": {
                                            "description": "Source-documented video_count; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Creator Growth. Known row fields: bio_email, category_label, channel_id, creator_oecuid, follower_count, handle, id, interval_new_follower, nickname, tioktok_creator_growth_interval_new_follower_ratio, uid, unique_id, user_avatar, user_sell_product_l1_category, video_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "bio_email": null,
                          "category_label": null,
                          "channel_id": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creator-rankings-growth",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creator_rankings_growth",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-rankings-commercial/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creator Commercial",
        "description": "Provider business records for TikTok Creator Commercial. Known row fields: bio_email, category_label, country_code, creator_oecuid, follower_count, handle, id, interval_ecom_video_play_count_growth, interval_live_user, interval_new_follower, l1_category_aggregated_live_gmv, l1_category_aggregated_total_gmv, l1_category_aggregated_video_gmv, nickname, product_count, titkok_creator_commercial_interval_live_gmv, titkok_creator_commercial_interval_total_video_live_gmv, titkok_creator_commercial_interval_video_gmv, uid, unique_id, user_avatar, user_sell_product_l1_category. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokCreatorRankingsCommercial",
        "externalDocs": {
          "description": "Nexscope TikTok Creator Commercial documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-rankings-commercial"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 20,
                    "example": 5
                  },
                  "date": {
                    "type": "string",
                    "description": "Ranking date in YYYYMMDD format.",
                    "pattern": "^[0-9]{8}$",
                    "example": "20260824"
                  },
                  "granularity": {
                    "type": "string",
                    "description": "Ranking period.",
                    "enum": [
                      "daily",
                      "weekly",
                      "monthly",
                      "0",
                      "1",
                      "2"
                    ],
                    "example": "daily"
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "total_gmv:desc",
                    "pattern": "^[A-Za-z0-9_]+:(asc|desc)$",
                    "example": "total_gmv:desc"
                  },
                  "creatorCategory": {
                    "type": "string",
                    "description": "Creator category."
                  },
                  "productCategory": {
                    "type": "string",
                    "description": "Product category."
                  }
                },
                "required": [
                  "country",
                  "date",
                  "granularity"
                ]
              },
              "example": {
                "country": "us",
                "pageSize": 10,
                "date": "20260828",
                "granularity": "daily"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "bio_email": {
                                            "description": "Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "category_label": {
                                            "description": "Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "country_code": {
                                            "description": "Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "creator_oecuid": {
                                            "description": "Source-documented creator_oecuid; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "follower_count": {
                                            "description": "Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "handle": {
                                            "description": "Source-documented handle; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_ecom_video_play_count_growth": {
                                            "description": "Source-documented interval_ecom_video_play_count_growth; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_live_user": {
                                            "description": "Source-documented interval_live_user; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_new_follower": {
                                            "description": "Source-documented interval_new_follower; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "l1_category_aggregated_live_gmv": {
                                            "description": "Source-documented l1_category_aggregated_live_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "l1_category_aggregated_total_gmv": {
                                            "description": "Source-documented l1_category_aggregated_total_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "l1_category_aggregated_video_gmv": {
                                            "description": "Source-documented l1_category_aggregated_video_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "nickname": {
                                            "description": "Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_count": {
                                            "description": "Source-documented product_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "titkok_creator_commercial_interval_live_gmv": {
                                            "description": "Source-documented titkok_creator_commercial_interval_live_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "titkok_creator_commercial_interval_total_video_live_gmv": {
                                            "description": "Source-documented titkok_creator_commercial_interval_total_video_live_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "titkok_creator_commercial_interval_video_gmv": {
                                            "description": "Source-documented titkok_creator_commercial_interval_video_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "uid": {
                                            "description": "Source-documented uid; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "unique_id": {
                                            "description": "Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_avatar": {
                                            "description": "Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_sell_product_l1_category": {
                                            "description": "Source-documented user_sell_product_l1_category; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Creator Commercial. Known row fields: bio_email, category_label, country_code, creator_oecuid, follower_count, handle, id, interval_ecom_video_play_count_growth, interval_live_user, interval_new_follower, l1_category_aggregated_live_gmv, l1_category_aggregated_total_gmv, l1_category_aggregated_video_gmv, nickname, product_count, titkok_creator_commercial_interval_live_gmv, titkok_creator_commercial_interval_total_video_live_gmv, titkok_creator_commercial_interval_video_gmv, uid, unique_id, user_avatar, user_sell_product_l1_category. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "bio_email": null,
                          "category_label": null,
                          "country_code": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creator-rankings-commercial",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creator_rankings_commercial",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-rankings-agencies/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creator Agencies",
        "description": "Provider business records for TikTok Creator Agencies. Known row fields: avg_commission_rate, follower_count, has_email_address, has_phone, has_whats_app, id, partner_icon, partner_id, partner_name, partner_top3_category, partner_top3_category_list, total_30d_video_live_gmv, total_30d_video_live_sold_count, total_related_creator_count, total_related_product_count, total_related_seller_count, video_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokCreatorRankingsAgencies",
        "externalDocs": {
          "description": "Nexscope TikTok Creator Agencies documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-rankings-agencies"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 20,
                    "example": 5
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "gmv_30d:desc",
                    "pattern": "^[A-Za-z0-9_]+:(asc|desc)$",
                    "example": "gmv_30d:desc"
                  },
                  "category": {
                    "type": "string",
                    "description": "Agency category."
                  }
                },
                "required": [
                  "country"
                ]
              },
              "example": {
                "country": "us",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "avg_commission_rate": {
                                            "description": "Source-documented avg_commission_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "follower_count": {
                                            "description": "Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "has_email_address": {
                                            "description": "Source-documented has_email_address; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "has_phone": {
                                            "description": "Source-documented has_phone; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "has_whats_app": {
                                            "description": "Source-documented has_whats_app; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "partner_icon": {
                                            "description": "Source-documented partner_icon; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "partner_id": {
                                            "description": "Source-documented partner_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "partner_name": {
                                            "description": "Source-documented partner_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "partner_top3_category": {
                                            "description": "Source-documented partner_top3_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "partner_top3_category_list": {
                                            "description": "Source-documented partner_top3_category_list; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_30d_video_live_gmv": {
                                            "description": "Source-documented total_30d_video_live_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_30d_video_live_sold_count": {
                                            "description": "Source-documented total_30d_video_live_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_related_creator_count": {
                                            "description": "Source-documented total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_related_product_count": {
                                            "description": "Source-documented total_related_product_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_related_seller_count": {
                                            "description": "Source-documented total_related_seller_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_count": {
                                            "description": "Source-documented video_count; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Creator Agencies. Known row fields: avg_commission_rate, follower_count, has_email_address, has_phone, has_whats_app, id, partner_icon, partner_id, partner_name, partner_top3_category, partner_top3_category_list, total_30d_video_live_gmv, total_30d_video_live_sold_count, total_related_creator_count, total_related_product_count, total_related_seller_count, video_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "avg_commission_rate": null,
                          "follower_count": null,
                          "has_email_address": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creator-rankings-agencies",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creator_rankings_agencies",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creator Search",
        "description": "Provider business records for TikTok Creator Search. Known row fields: account_type, author_avg_engagement_rate, bio_email, category_label, country_code, ecom_video_avg_play_count, facebook_url, follower_count, follower_count_growth_for_last_7_days, has_live_product, has_shop_product, has_video_product, id, ins_id, live_30d_gmv, live_30d_gpm, nickname, product_category_label_list, total_favorited, total_video_live_30d_gmv, unique_id, user_avatar, user_sell_product_l3_category, video_30d_gmv, video_30d_gpm, video_avg_like_count, video_avg_play_count, video_total_like_count_to_follower_count_ratio, youtube_channel_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokCreatorSearch",
        "externalDocs": {
          "description": "Nexscope TikTok Creator Search documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Creator search keyword.",
                    "example": "beauty"
                  },
                  "category": {
                    "type": "string",
                    "description": "Creator category."
                  },
                  "hasContact": {
                    "type": "boolean",
                    "description": "Filter by availability of public contact information.",
                    "example": true
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "gmv_30d:desc",
                    "pattern": "^[A-Za-z0-9_]+:(asc|desc)$",
                    "example": "gmv_30d:desc"
                  },
                  "minFollowers": {
                    "type": "number",
                    "description": "Minimum follower count."
                  },
                  "maxFollowers": {
                    "type": "number",
                    "description": "Maximum follower count."
                  },
                  "minGmv30d": {
                    "type": "number",
                    "description": "Minimum 30-day GMV."
                  },
                  "maxGmv30d": {
                    "type": "number",
                    "description": "Maximum 30-day GMV."
                  },
                  "minAvgViews": {
                    "type": "number",
                    "description": "Minimum average view count."
                  },
                  "maxAvgViews": {
                    "type": "number",
                    "description": "Maximum average view count."
                  },
                  "minEngagement": {
                    "type": "number",
                    "description": "Minimum engagement rate."
                  },
                  "maxEngagement": {
                    "type": "number",
                    "description": "Maximum engagement rate."
                  }
                },
                "required": [
                  "country"
                ]
              },
              "example": {
                "country": "us",
                "keyword": "beauty",
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "account_type": {
                                            "description": "Source-documented account_type; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "author_avg_engagement_rate": {
                                            "description": "Source-documented author_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "bio_email": {
                                            "description": "Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "category_label": {
                                            "description": "Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "country_code": {
                                            "description": "Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "ecom_video_avg_play_count": {
                                            "description": "Source-documented ecom_video_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "facebook_url": {
                                            "description": "Source-documented facebook_url; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "follower_count": {
                                            "description": "Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "follower_count_growth_for_last_7_days": {
                                            "description": "Source-documented follower_count_growth_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "has_live_product": {
                                            "description": "Source-documented has_live_product; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "has_shop_product": {
                                            "description": "Source-documented has_shop_product; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "has_video_product": {
                                            "description": "Source-documented has_video_product; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "ins_id": {
                                            "description": "Source-documented ins_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "live_30d_gmv": {
                                            "description": "Source-documented live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "live_30d_gpm": {
                                            "description": "Source-documented live_30d_gpm; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "nickname": {
                                            "description": "Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_category_label_list": {
                                            "description": "Source-documented product_category_label_list; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_favorited": {
                                            "description": "Source-documented total_favorited; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_video_live_30d_gmv": {
                                            "description": "Source-documented total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "unique_id": {
                                            "description": "Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_avatar": {
                                            "description": "Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_sell_product_l3_category": {
                                            "description": "Source-documented user_sell_product_l3_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_30d_gmv": {
                                            "description": "Source-documented video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_30d_gpm": {
                                            "description": "Source-documented video_30d_gpm; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_avg_like_count": {
                                            "description": "Source-documented video_avg_like_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_avg_play_count": {
                                            "description": "Source-documented video_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_total_like_count_to_follower_count_ratio": {
                                            "description": "Source-documented video_total_like_count_to_follower_count_ratio; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "youtube_channel_id": {
                                            "description": "Source-documented youtube_channel_id; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Creator Search. Known row fields: account_type, author_avg_engagement_rate, bio_email, category_label, country_code, ecom_video_avg_play_count, facebook_url, follower_count, follower_count_growth_for_last_7_days, has_live_product, has_shop_product, has_video_product, id, ins_id, live_30d_gmv, live_30d_gpm, nickname, product_category_label_list, total_favorited, total_video_live_30d_gmv, unique_id, user_avatar, user_sell_product_l3_category, video_30d_gmv, video_30d_gpm, video_avg_like_count, video_avg_play_count, video_total_like_count_to_follower_count_ratio, youtube_channel_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "account_type": null,
                          "author_avg_engagement_rate": null,
                          "bio_email": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creator-search",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creator_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-rankings-top-selling/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Shop Top Selling",
        "description": "Provider business records for TikTok Shop Top Selling. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_sold_count, interval_gmv, interval_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokShopRankingsTopSelling",
        "externalDocs": {
          "description": "Nexscope TikTok Shop Top Selling documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-rankings-top-selling"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 20,
                    "example": 5
                  },
                  "date": {
                    "type": "string",
                    "description": "Ranking date in YYYYMMDD format.",
                    "pattern": "^[0-9]{8}$",
                    "example": "20260824"
                  },
                  "granularity": {
                    "type": "string",
                    "description": "Ranking period.",
                    "enum": [
                      "daily",
                      "weekly",
                      "monthly",
                      "0",
                      "1",
                      "2"
                    ],
                    "example": "daily"
                  },
                  "category": {
                    "type": "string",
                    "description": "Product category ID."
                  },
                  "shopType": {
                    "type": "string",
                    "description": "Provider shop type.",
                    "enum": [
                      "1",
                      "2",
                      "3",
                      "4"
                    ]
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "interval_sold_count:desc",
                    "pattern": "^[A-Za-z0-9_]+:(asc|desc)$",
                    "example": "interval_sold_count:desc"
                  }
                },
                "required": [
                  "country",
                  "date",
                  "granularity"
                ]
              },
              "example": {
                "country": "us",
                "date": "20260824",
                "granularity": "daily",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_id": {
                                            "description": "Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_name": {
                                            "description": "Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "region": {
                                            "description": "Source-documented region; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_rating": {
                                            "description": "Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_product_count": {
                                            "description": "Source-documented shop_product_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_main_category": {
                                            "description": "Source-documented seller_main_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_business_info": {
                                            "description": "Source-documented seller_business_info; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_avatar": {
                                            "description": "Source-documented seller_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "biz_type": {
                                            "description": "Source-documented biz_type; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_sold_count": {
                                            "description": "Source-documented interval_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_total_sold_count": {
                                            "description": "Source-documented interval_total_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_sold_count_growth_rate": {
                                            "description": "Source-documented interval_sold_count_growth_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_gmv": {
                                            "description": "Source-documented interval_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_total_gmv": {
                                            "description": "Source-documented interval_total_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_gmv_pop_growth_rate": {
                                            "description": "Source-documented interval_gmv_pop_growth_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_related_creator_count": {
                                            "description": "Source-documented interval_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_total_related_creator_count": {
                                            "description": "Source-documented interval_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Shop Top Selling. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_sold_count, interval_gmv, interval_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "seller_id": null,
                          "shop_name": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-shop-rankings-top-selling",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_shop_rankings_top_selling",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-rankings-most-promoted/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Shop Most Promoted",
        "description": "Provider business records for TikTok Shop Most Promoted. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_related_creator_count, interval_total_related_creator_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokShopRankingsMostPromoted",
        "externalDocs": {
          "description": "Nexscope TikTok Shop Most Promoted documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-rankings-most-promoted"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 20,
                    "example": 5
                  },
                  "date": {
                    "type": "string",
                    "description": "Ranking date in YYYYMMDD format.",
                    "pattern": "^[0-9]{8}$",
                    "example": "20260824"
                  },
                  "granularity": {
                    "type": "string",
                    "description": "Ranking period.",
                    "enum": [
                      "daily",
                      "weekly",
                      "monthly",
                      "0",
                      "1",
                      "2"
                    ],
                    "example": "daily"
                  },
                  "category": {
                    "type": "string",
                    "description": "Product category ID."
                  },
                  "shopType": {
                    "type": "string",
                    "description": "Provider shop type.",
                    "enum": [
                      "1",
                      "2",
                      "3",
                      "4"
                    ]
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "related_creator_count:desc",
                    "pattern": "^[A-Za-z0-9_]+:(asc|desc)$",
                    "example": "related_creator_count:desc"
                  }
                },
                "required": [
                  "country",
                  "date",
                  "granularity"
                ]
              },
              "example": {
                "country": "us",
                "date": "20260824",
                "granularity": "daily",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_id": {
                                            "description": "Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_name": {
                                            "description": "Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "region": {
                                            "description": "Source-documented region; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_rating": {
                                            "description": "Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_product_count": {
                                            "description": "Source-documented shop_product_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_main_category": {
                                            "description": "Source-documented seller_main_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_business_info": {
                                            "description": "Source-documented seller_business_info; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_avatar": {
                                            "description": "Source-documented seller_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "biz_type": {
                                            "description": "Source-documented biz_type; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_related_creator_count": {
                                            "description": "Source-documented interval_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_total_related_creator_count": {
                                            "description": "Source-documented interval_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_total_related_video_creator_count": {
                                            "description": "Source-documented interval_total_related_video_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_total_related_shop_creator_count": {
                                            "description": "Source-documented interval_total_related_shop_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_total_related_videos_count": {
                                            "description": "Source-documented interval_total_related_videos_count; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Shop Most Promoted. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_related_creator_count, interval_total_related_creator_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "seller_id": null,
                          "shop_name": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-shop-rankings-most-promoted",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_shop_rankings_most_promoted",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Shop Search",
        "description": "Provider business records for TikTok Shop Search. Known row fields: id, shop_name, region, shop_rating, shop_product_count, shop_total_sold_count, shop_total_gmv, shop_sold_count_for_last_7_days, shop_gmv_for_last_7_days. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokShopSearch",
        "externalDocs": {
          "description": "Nexscope TikTok Shop Search documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Shop search keyword.",
                    "example": "beauty"
                  },
                  "category": {
                    "type": "string",
                    "description": "Product category ID."
                  },
                  "sellerType": {
                    "type": "string",
                    "description": "Provider-supported seller type."
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "gmv_7d:desc",
                    "pattern": "^[A-Za-z0-9_]+:(asc|desc)$",
                    "example": "gmv_7d:desc"
                  },
                  "minRating": {
                    "type": "number",
                    "description": "Minimum shop rating."
                  },
                  "maxRating": {
                    "type": "number",
                    "description": "Maximum shop rating."
                  },
                  "minSold7d": {
                    "type": "number",
                    "description": "Minimum 7-day sales."
                  },
                  "maxSold7d": {
                    "type": "number",
                    "description": "Maximum 7-day sales."
                  },
                  "minGmv7d": {
                    "type": "number",
                    "description": "Minimum 7-day GMV."
                  },
                  "maxGmv7d": {
                    "type": "number",
                    "description": "Maximum 7-day GMV."
                  }
                },
                "required": [
                  "country"
                ]
              },
              "example": {
                "country": "us",
                "keyword": "beauty",
                "minRating": 4,
                "pageSize": 3
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_name": {
                                            "description": "Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "region": {
                                            "description": "Source-documented region; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_rating": {
                                            "description": "Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_product_count": {
                                            "description": "Source-documented shop_product_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_total_sold_count": {
                                            "description": "Source-documented shop_total_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_total_gmv": {
                                            "description": "Source-documented shop_total_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_sold_count_for_last_7_days": {
                                            "description": "Source-documented shop_sold_count_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_gmv_for_last_7_days": {
                                            "description": "Source-documented shop_gmv_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_main_category": {
                                            "description": "Source-documented shop_main_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_related_creator_count": {
                                            "description": "Source-documented total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_business_info": {
                                            "description": "Source-documented seller_business_info; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "sold_count_trend": {
                                            "description": "Source-documented sold_count_trend; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Shop Search. Known row fields: id, shop_name, region, shop_rating, shop_product_count, shop_total_sold_count, shop_total_gmv, shop_sold_count_for_last_7_days, shop_gmv_for_last_7_days. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "shop_name": null,
                          "region": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-shop-search",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_shop_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-image-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Image Search",
        "description": "Provider business records for TikTok Product Image Search. Known row fields: id, product_name, product_images, floor_price, ceiling_price, product_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductImageSearch",
        "externalDocs": {
          "description": "Nexscope TikTok Product Image Search documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-image-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "osKey": {
                    "type": "string",
                    "description": "osKey returned after uploading the image through the Nexscope provider upload flow; obtain this value before calling.",
                    "minLength": 1
                  },
                  "country": {
                    "type": "string",
                    "description": "Uppercase two-letter market code.",
                    "default": "US",
                    "pattern": "^[A-Z]{2}$",
                    "example": "US"
                  }
                },
                "required": [
                  "osKey"
                ]
              },
              "example": {
                "osKey": "",
                "country": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_id": {
                                            "description": "Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_name": {
                                            "description": "Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_images": {
                                            "description": "Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "floor_price": {
                                            "description": "Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "ceiling_price": {
                                            "description": "Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_rating": {
                                            "description": "Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_sold_count": {
                                            "description": "Source-documented product_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_gmv": {
                                            "description": "Source-documented product_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_l1_category": {
                                            "description": "Source-documented product_l1_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_l2_category": {
                                            "description": "Source-documented product_l2_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_l3_category": {
                                            "description": "Source-documented product_l3_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "country_code": {
                                            "description": "Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "region": {
                                            "description": "Source-documented region; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product Image Search. Known row fields: id, product_name, product_images, floor_price, ceiling_price, product_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "product_id": null,
                          "product_name": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-image-search",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_image_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-rankings-new-arrivals/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product New Arrivals",
        "description": "Provider business records for TikTok Product New Arrivals. Known row fields: id, product_id, product_name, shop_name, total_gmv, total_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductRankingsNewArrivals",
        "externalDocs": {
          "description": "Nexscope TikTok Product New Arrivals documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-rankings-new-arrivals"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 20,
                    "example": 5
                  },
                  "category": {
                    "type": "string",
                    "description": "Product category ID."
                  },
                  "sellerType": {
                    "type": "string",
                    "description": "Seller type.",
                    "enum": [
                      "1",
                      "2",
                      "3",
                      "4"
                    ]
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "gmv_3d:desc",
                    "pattern": "^(gmv_3d|sold_count_3d|total_gmv|total_sold_count):(asc|desc)$",
                    "example": "gmv_3d:desc"
                  },
                  "listedFrom": {
                    "type": "string",
                    "description": "Earliest listing date in YYYYMMDD format.",
                    "pattern": "^[0-9]{8}$"
                  },
                  "listedTo": {
                    "type": "string",
                    "description": "Latest listing date in YYYYMMDD format.",
                    "pattern": "^[0-9]{8}$"
                  },
                  "productStatus": {
                    "type": "string",
                    "description": "Provider product status.",
                    "enum": [
                      "1",
                      "2",
                      "3",
                      "4"
                    ]
                  }
                },
                "required": [
                  "country"
                ]
              },
              "example": {
                "country": "us",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_id": {
                                            "description": "Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_name": {
                                            "description": "Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_images": {
                                            "description": "Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_name": {
                                            "description": "Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_id": {
                                            "description": "Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "floor_price": {
                                            "description": "Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "ceiling_price": {
                                            "description": "Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_rating": {
                                            "description": "Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_gmv": {
                                            "description": "Source-documented total_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_sold_count": {
                                            "description": "Source-documented total_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "gmv_3d": {
                                            "description": "Source-documented gmv_3d; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "sold_count_3d": {
                                            "description": "Source-documented sold_count_3d; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "gmv_7d": {
                                            "description": "Source-documented gmv_7d; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "sold_count_7d": {
                                            "description": "Source-documented sold_count_7d; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_status": {
                                            "description": "Source-documented product_status; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "create_time": {
                                            "description": "Source-documented create_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "sold_count_trend": {
                                            "description": "Source-documented sold_count_trend; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product New Arrivals. Known row fields: id, product_id, product_name, shop_name, total_gmv, total_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "product_id": null,
                          "product_name": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-rankings-new-arrivals",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_rankings_new_arrivals",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-rankings-top-selling/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Top Selling",
        "description": "Provider business records for TikTok Product Top Selling. Known row fields: id, product_id, product_name, shop_name, interval_gmv, interval_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductRankingsTopSelling",
        "externalDocs": {
          "description": "Nexscope TikTok Product Top Selling documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-rankings-top-selling"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 20,
                    "example": 5
                  },
                  "date": {
                    "type": "string",
                    "description": "Ranking date in YYYYMMDD format.",
                    "pattern": "^[0-9]{8}$",
                    "example": "20260824"
                  },
                  "granularity": {
                    "type": "string",
                    "description": "Ranking period.",
                    "enum": [
                      "daily",
                      "weekly",
                      "monthly",
                      "0",
                      "1",
                      "2"
                    ],
                    "example": "daily"
                  },
                  "category": {
                    "type": "string",
                    "description": "Product category ID."
                  },
                  "sellerType": {
                    "type": "string",
                    "description": "Seller type.",
                    "enum": [
                      "1",
                      "2",
                      "3",
                      "4"
                    ]
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "interval_sold_count:desc",
                    "pattern": "^(gmv_growth_rate|interval_gmv|interval_sold_count|sold_count_growth_rate|total_gmv|total_sold_count):(asc|desc)$",
                    "example": "interval_sold_count:desc"
                  }
                },
                "required": [
                  "country",
                  "date",
                  "granularity"
                ]
              },
              "example": {
                "country": "us",
                "pageSize": 10,
                "date": "20260824",
                "granularity": "daily"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_id": {
                                            "description": "Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_name": {
                                            "description": "Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_images": {
                                            "description": "Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_name": {
                                            "description": "Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_id": {
                                            "description": "Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "floor_price": {
                                            "description": "Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "ceiling_price": {
                                            "description": "Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_rating": {
                                            "description": "Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_gmv": {
                                            "description": "Source-documented interval_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_sold_count": {
                                            "description": "Source-documented interval_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_gmv": {
                                            "description": "Source-documented total_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_sold_count": {
                                            "description": "Source-documented total_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "gmv_growth_rate": {
                                            "description": "Source-documented gmv_growth_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "sold_count_growth_rate": {
                                            "description": "Source-documented sold_count_growth_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "live_count": {
                                            "description": "Source-documented live_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "related_creator_count": {
                                            "description": "Source-documented related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_play_count": {
                                            "description": "Source-documented video_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product Top Selling. Known row fields: id, product_id, product_name, shop_name, interval_gmv, interval_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "product_id": null,
                          "product_name": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-rankings-top-selling",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_rankings_top_selling",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-rankings-most-promoted/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Most Promoted",
        "description": "Provider business records for TikTok Product Most Promoted. Known row fields: id, product_id, product_name, shop_name, interval_gmv, interval_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductRankingsMostPromoted",
        "externalDocs": {
          "description": "Nexscope TikTok Product Most Promoted documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-rankings-most-promoted"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 20,
                    "example": 5
                  },
                  "date": {
                    "type": "string",
                    "description": "Ranking date in YYYYMMDD format.",
                    "pattern": "^[0-9]{8}$",
                    "example": "20260824"
                  },
                  "granularity": {
                    "type": "string",
                    "description": "Ranking period.",
                    "enum": [
                      "daily",
                      "weekly",
                      "monthly",
                      "0",
                      "1",
                      "2"
                    ],
                    "example": "daily"
                  },
                  "category": {
                    "type": "string",
                    "description": "Product category ID."
                  },
                  "sellerType": {
                    "type": "string",
                    "description": "Seller type.",
                    "enum": [
                      "1",
                      "2",
                      "3",
                      "4"
                    ]
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "related_creator_count:desc",
                    "pattern": "^(interval_gmv|interval_sold_count|live_count|live_user_count|related_creator_count|video_play_count):(asc|desc)$",
                    "example": "related_creator_count:desc"
                  }
                },
                "required": [
                  "country",
                  "date",
                  "granularity"
                ]
              },
              "example": {
                "country": "us",
                "pageSize": 10,
                "date": "20260824",
                "granularity": "daily"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_id": {
                                            "description": "Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_name": {
                                            "description": "Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_images": {
                                            "description": "Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_name": {
                                            "description": "Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_id": {
                                            "description": "Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "floor_price": {
                                            "description": "Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "ceiling_price": {
                                            "description": "Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_gmv": {
                                            "description": "Source-documented interval_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "interval_sold_count": {
                                            "description": "Source-documented interval_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "live_count": {
                                            "description": "Source-documented live_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "live_user_count": {
                                            "description": "Source-documented live_user_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "related_creator_count": {
                                            "description": "Source-documented related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_play_count": {
                                            "description": "Source-documented video_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_rating": {
                                            "description": "Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_status": {
                                            "description": "Source-documented product_status; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product Most Promoted. Known row fields: id, product_id, product_name, shop_name, interval_gmv, interval_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "product_id": null,
                          "product_name": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-rankings-most-promoted",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_rankings_most_promoted",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-related-videos/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creator Related Videos",
        "description": "Provider business records for TikTok Creator Related Videos. Known row fields: id, tiktok_creator_detail_is_ad, tiktok_creator_detail_is_aigc_video, tiktok_creator_detail_video_30d_gmv, tiktok_creator_detail_video_30d_sold_count, tiktok_creator_detail_video_ad_source, tiktok_creator_detail_video_author_category_label, tiktok_creator_detail_video_author_nickname, tiktok_creator_detail_video_author_uid, tiktok_creator_detail_video_author_unique_id, tiktok_creator_detail_video_collect_count, tiktok_creator_detail_video_comment_count, tiktok_creator_detail_video_country_code, tiktok_creator_detail_video_cover, tiktok_creator_detail_video_desc, tiktok_creator_detail_video_duration, tiktok_creator_detail_video_engagement_rate, tiktok_creator_detail_video_id, tiktok_creator_detail_video_launch_time, tiktok_creator_detail_video_like_count, tiktok_creator_detail_video_play_count, tiktok_creator_detail_video_product_id, tiktok_creator_detail_video_product_images, tiktok_creator_detail_video_product_l1_category, tiktok_creator_detail_video_product_l2_category, tiktok_creator_detail_video_product_l3_category, tiktok_creator_detail_video_product_title, tiktok_creator_detail_video_share_count, tiktok_creator_detail_video_share_url, tiktok_creator_detail_video_total_like_count_to_follower_count_ratio, tiktok_creator_detail_video_user_avatar. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokCreatorRelatedVideos",
        "externalDocs": {
          "description": "Nexscope TikTok Creator Related Videos documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-related-videos"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Creator ID, preserved as a string.",
                    "minLength": 1,
                    "example": "7302162228386776110"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "7302162228386776110",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_is_ad": {
                                            "description": "Source-documented tiktok_creator_detail_is_ad; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_is_aigc_video": {
                                            "description": "Source-documented tiktok_creator_detail_is_aigc_video; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_30d_gmv": {
                                            "description": "Source-documented tiktok_creator_detail_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_30d_sold_count": {
                                            "description": "Source-documented tiktok_creator_detail_video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_ad_source": {
                                            "description": "Source-documented tiktok_creator_detail_video_ad_source; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_author_category_label": {
                                            "description": "Source-documented tiktok_creator_detail_video_author_category_label; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_author_nickname": {
                                            "description": "Source-documented tiktok_creator_detail_video_author_nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_author_uid": {
                                            "description": "Source-documented tiktok_creator_detail_video_author_uid; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_author_unique_id": {
                                            "description": "Source-documented tiktok_creator_detail_video_author_unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_collect_count": {
                                            "description": "Source-documented tiktok_creator_detail_video_collect_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_comment_count": {
                                            "description": "Source-documented tiktok_creator_detail_video_comment_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_country_code": {
                                            "description": "Source-documented tiktok_creator_detail_video_country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_cover": {
                                            "description": "Source-documented tiktok_creator_detail_video_cover; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_desc": {
                                            "description": "Source-documented tiktok_creator_detail_video_desc; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_duration": {
                                            "description": "Source-documented tiktok_creator_detail_video_duration; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_engagement_rate": {
                                            "description": "Source-documented tiktok_creator_detail_video_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_id": {
                                            "description": "Source-documented tiktok_creator_detail_video_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_launch_time": {
                                            "description": "Source-documented tiktok_creator_detail_video_launch_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_like_count": {
                                            "description": "Source-documented tiktok_creator_detail_video_like_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_play_count": {
                                            "description": "Source-documented tiktok_creator_detail_video_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_product_id": {
                                            "description": "Source-documented tiktok_creator_detail_video_product_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_product_images": {
                                            "description": "Source-documented tiktok_creator_detail_video_product_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_product_l1_category": {
                                            "description": "Source-documented tiktok_creator_detail_video_product_l1_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_product_l2_category": {
                                            "description": "Source-documented tiktok_creator_detail_video_product_l2_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_product_l3_category": {
                                            "description": "Source-documented tiktok_creator_detail_video_product_l3_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_product_title": {
                                            "description": "Source-documented tiktok_creator_detail_video_product_title; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_share_count": {
                                            "description": "Source-documented tiktok_creator_detail_video_share_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_share_url": {
                                            "description": "Source-documented tiktok_creator_detail_video_share_url; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_total_like_count_to_follower_count_ratio": {
                                            "description": "Source-documented tiktok_creator_detail_video_total_like_count_to_follower_count_ratio; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_user_avatar": {
                                            "description": "Source-documented tiktok_creator_detail_video_user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Creator Related Videos. Known row fields: id, tiktok_creator_detail_is_ad, tiktok_creator_detail_is_aigc_video, tiktok_creator_detail_video_30d_gmv, tiktok_creator_detail_video_30d_sold_count, tiktok_creator_detail_video_ad_source, tiktok_creator_detail_video_author_category_label, tiktok_creator_detail_video_author_nickname, tiktok_creator_detail_video_author_uid, tiktok_creator_detail_video_author_unique_id, tiktok_creator_detail_video_collect_count, tiktok_creator_detail_video_comment_count, tiktok_creator_detail_video_country_code, tiktok_creator_detail_video_cover, tiktok_creator_detail_video_desc, tiktok_creator_detail_video_duration, tiktok_creator_detail_video_engagement_rate, tiktok_creator_detail_video_id, tiktok_creator_detail_video_launch_time, tiktok_creator_detail_video_like_count, tiktok_creator_detail_video_play_count, tiktok_creator_detail_video_product_id, tiktok_creator_detail_video_product_images, tiktok_creator_detail_video_product_l1_category, tiktok_creator_detail_video_product_l2_category, tiktok_creator_detail_video_product_l3_category, tiktok_creator_detail_video_product_title, tiktok_creator_detail_video_share_count, tiktok_creator_detail_video_share_url, tiktok_creator_detail_video_total_like_count_to_follower_count_ratio, tiktok_creator_detail_video_user_avatar. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "tiktok_creator_detail_is_ad": null,
                          "tiktok_creator_detail_is_aigc_video": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creator-related-videos",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creator_related_videos",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-related-products/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creator Related Products",
        "description": "Provider business records for TikTok Creator Related Products. Known row fields: id, tiktok_creator_detail_by_live, tiktok_creator_detail_by_shop, tiktok_creator_detail_by_video, tiktok_creator_detail_live_30d_gmv, tiktok_creator_detail_live_30d_sold_count, tiktok_creator_detail_product_country_code, tiktok_creator_detail_product_id, tiktok_creator_detail_product_launch_time, tiktok_creator_detail_total_video_live_30d_gmv, tiktok_creator_detail_total_video_live_30d_sold_count, tiktok_creator_detail_user_id, tiktok_creator_detail_video_30d_gmv, tiktok_creator_detail_video_30d_sold_count, tiktok_product_detail_ceiling_price, tiktok_product_detail_commission_rate, tiktok_product_detail_floor_price, tiktok_product_detail_l1_category, tiktok_product_detail_l2_category, tiktok_product_detail_l3_category, tiktok_product_detail_product_images, tiktok_product_detail_product_name, tiktok_product_detail_product_rating, tiktok_product_detail_product_sku_props, tiktok_product_detail_product_skus, tiktok_product_detail_product_status, tiktok_product_detail_region. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokCreatorRelatedProducts",
        "externalDocs": {
          "description": "Nexscope TikTok Creator Related Products documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-related-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Creator ID, preserved as a string.",
                    "minLength": 1,
                    "example": "7302162228386776110"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "7302162228386776110",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_by_live": {
                                            "description": "Source-documented tiktok_creator_detail_by_live; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_by_shop": {
                                            "description": "Source-documented tiktok_creator_detail_by_shop; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_by_video": {
                                            "description": "Source-documented tiktok_creator_detail_by_video; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_30d_gmv": {
                                            "description": "Source-documented tiktok_creator_detail_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_30d_sold_count": {
                                            "description": "Source-documented tiktok_creator_detail_live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_product_country_code": {
                                            "description": "Source-documented tiktok_creator_detail_product_country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_product_id": {
                                            "description": "Source-documented tiktok_creator_detail_product_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_product_launch_time": {
                                            "description": "Source-documented tiktok_creator_detail_product_launch_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_total_video_live_30d_gmv": {
                                            "description": "Source-documented tiktok_creator_detail_total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_total_video_live_30d_sold_count": {
                                            "description": "Source-documented tiktok_creator_detail_total_video_live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_user_id": {
                                            "description": "Source-documented tiktok_creator_detail_user_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_30d_gmv": {
                                            "description": "Source-documented tiktok_creator_detail_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_video_30d_sold_count": {
                                            "description": "Source-documented tiktok_creator_detail_video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_ceiling_price": {
                                            "description": "Source-documented tiktok_product_detail_ceiling_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_commission_rate": {
                                            "description": "Source-documented tiktok_product_detail_commission_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_floor_price": {
                                            "description": "Source-documented tiktok_product_detail_floor_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_l1_category": {
                                            "description": "Source-documented tiktok_product_detail_l1_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_l2_category": {
                                            "description": "Source-documented tiktok_product_detail_l2_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_l3_category": {
                                            "description": "Source-documented tiktok_product_detail_l3_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_product_images": {
                                            "description": "Source-documented tiktok_product_detail_product_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_product_name": {
                                            "description": "Source-documented tiktok_product_detail_product_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_product_rating": {
                                            "description": "Source-documented tiktok_product_detail_product_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_product_sku_props": {
                                            "description": "Source-documented tiktok_product_detail_product_sku_props; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_product_skus": {
                                            "description": "Source-documented tiktok_product_detail_product_skus; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_product_status": {
                                            "description": "Source-documented tiktok_product_detail_product_status; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_product_detail_region": {
                                            "description": "Source-documented tiktok_product_detail_region; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Creator Related Products. Known row fields: id, tiktok_creator_detail_by_live, tiktok_creator_detail_by_shop, tiktok_creator_detail_by_video, tiktok_creator_detail_live_30d_gmv, tiktok_creator_detail_live_30d_sold_count, tiktok_creator_detail_product_country_code, tiktok_creator_detail_product_id, tiktok_creator_detail_product_launch_time, tiktok_creator_detail_total_video_live_30d_gmv, tiktok_creator_detail_total_video_live_30d_sold_count, tiktok_creator_detail_user_id, tiktok_creator_detail_video_30d_gmv, tiktok_creator_detail_video_30d_sold_count, tiktok_product_detail_ceiling_price, tiktok_product_detail_commission_rate, tiktok_product_detail_floor_price, tiktok_product_detail_l1_category, tiktok_product_detail_l2_category, tiktok_product_detail_l3_category, tiktok_product_detail_product_images, tiktok_product_detail_product_name, tiktok_product_detail_product_rating, tiktok_product_detail_product_sku_props, tiktok_product_detail_product_skus, tiktok_product_detail_product_status, tiktok_product_detail_region. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "tiktok_creator_detail_by_live": null,
                          "tiktok_creator_detail_by_shop": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creator-related-products",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creator_related_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-related-lives/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creator Related Lives",
        "description": "Provider business records for TikTok Creator Related Lives. Known row fields: id, tiktok_creator_detail_live_country_code, tiktok_creator_detail_live_cover, tiktok_creator_detail_live_end_time, tiktok_creator_detail_live_gmv, tiktok_creator_detail_live_gpm, tiktok_creator_detail_live_max_user_count, tiktok_creator_detail_live_most_product_category_label, tiktok_creator_detail_live_new_follow_count, tiktok_creator_detail_live_opm, tiktok_creator_detail_live_product_count, tiktok_creator_detail_live_room_id, tiktok_creator_detail_live_room_link, tiktok_creator_detail_live_start_time, tiktok_creator_detail_live_title, tiktok_creator_detail_live_total_sold_count, tiktok_creator_detail_live_total_user, tiktok_creator_detail_live_user_follower_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokCreatorRelatedLives",
        "externalDocs": {
          "description": "Nexscope TikTok Creator Related Lives documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-related-lives"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Creator ID, preserved as a string.",
                    "minLength": 1,
                    "example": "7302162228386776110"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "7302162228386776110",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_country_code": {
                                            "description": "Source-documented tiktok_creator_detail_live_country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_cover": {
                                            "description": "Source-documented tiktok_creator_detail_live_cover; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_end_time": {
                                            "description": "Source-documented tiktok_creator_detail_live_end_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_gmv": {
                                            "description": "Source-documented tiktok_creator_detail_live_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_gpm": {
                                            "description": "Source-documented tiktok_creator_detail_live_gpm; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_max_user_count": {
                                            "description": "Source-documented tiktok_creator_detail_live_max_user_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_most_product_category_label": {
                                            "description": "Source-documented tiktok_creator_detail_live_most_product_category_label; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_new_follow_count": {
                                            "description": "Source-documented tiktok_creator_detail_live_new_follow_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_opm": {
                                            "description": "Source-documented tiktok_creator_detail_live_opm; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_product_count": {
                                            "description": "Source-documented tiktok_creator_detail_live_product_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_room_id": {
                                            "description": "Source-documented tiktok_creator_detail_live_room_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_room_link": {
                                            "description": "Source-documented tiktok_creator_detail_live_room_link; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_start_time": {
                                            "description": "Source-documented tiktok_creator_detail_live_start_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_title": {
                                            "description": "Source-documented tiktok_creator_detail_live_title; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_total_sold_count": {
                                            "description": "Source-documented tiktok_creator_detail_live_total_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_total_user": {
                                            "description": "Source-documented tiktok_creator_detail_live_total_user; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_creator_detail_live_user_follower_count": {
                                            "description": "Source-documented tiktok_creator_detail_live_user_follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Creator Related Lives. Known row fields: id, tiktok_creator_detail_live_country_code, tiktok_creator_detail_live_cover, tiktok_creator_detail_live_end_time, tiktok_creator_detail_live_gmv, tiktok_creator_detail_live_gpm, tiktok_creator_detail_live_max_user_count, tiktok_creator_detail_live_most_product_category_label, tiktok_creator_detail_live_new_follow_count, tiktok_creator_detail_live_opm, tiktok_creator_detail_live_product_count, tiktok_creator_detail_live_room_id, tiktok_creator_detail_live_room_link, tiktok_creator_detail_live_start_time, tiktok_creator_detail_live_title, tiktok_creator_detail_live_total_sold_count, tiktok_creator_detail_live_total_user, tiktok_creator_detail_live_user_follower_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "tiktok_creator_detail_live_country_code": null,
                          "tiktok_creator_detail_live_cover": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creator-related-lives",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creator_related_lives",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-related-videos/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Shop Related Videos",
        "description": "Provider business records for TikTok Shop Related Videos. Known row fields: id, tiktok_seller_detail_video_id, tiktok_seller_detail_video_desc, tiktok_seller_detail_video_play_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokShopRelatedVideos",
        "externalDocs": {
          "description": "Nexscope TikTok Shop Related Videos documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-related-videos"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Shop ID, preserved as a string.",
                    "minLength": 1,
                    "example": "7495205878591949358"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "7495205878591949358",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_id": {
                                            "description": "Source-documented tiktok_seller_detail_video_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_seller_id": {
                                            "description": "Source-documented tiktok_seller_detail_video_seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_desc": {
                                            "description": "Source-documented tiktok_seller_detail_video_desc; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_share_url": {
                                            "description": "Source-documented tiktok_seller_detail_share_url; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_cover_url": {
                                            "description": "Source-documented tiktok_seller_detail_cover_url; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_launch_time": {
                                            "description": "Source-documented tiktok_seller_detail_video_launch_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_duration": {
                                            "description": "Source-documented tiktok_seller_detail_video_duration; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_play_count": {
                                            "description": "Source-documented tiktok_seller_detail_video_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_30d_play_count": {
                                            "description": "Source-documented tiktok_seller_detail_video_30d_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_like_count": {
                                            "description": "Source-documented tiktok_seller_detail_video_like_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_comment_count": {
                                            "description": "Source-documented tiktok_seller_detail_video_comment_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_engagement_rate": {
                                            "description": "Source-documented tiktok_seller_detail_video_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_30d_sold_count": {
                                            "description": "Source-documented tiktok_seller_detail_video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_30d_gmv": {
                                            "description": "Source-documented tiktok_seller_detail_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_is_ad": {
                                            "description": "Source-documented tiktok_seller_detail_is_ad; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_is_aigc_video": {
                                            "description": "Source-documented tiktok_seller_detail_is_aigc_video; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_video_ad_source": {
                                            "description": "Source-documented tiktok_seller_detail_video_ad_source; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_user_id": {
                                            "description": "Source-documented tiktok_seller_detail_user_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_user_unique_id": {
                                            "description": "Source-documented tiktok_seller_detail_user_unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_user_nickname": {
                                            "description": "Source-documented tiktok_seller_detail_user_nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_user_avatar": {
                                            "description": "Source-documented tiktok_seller_detail_user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_follower_count": {
                                            "description": "Source-documented tiktok_seller_detail_follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Shop Related Videos. Known row fields: id, tiktok_seller_detail_video_id, tiktok_seller_detail_video_desc, tiktok_seller_detail_video_play_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "tiktok_seller_detail_video_id": null,
                          "tiktok_seller_detail_video_seller_id": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-shop-related-videos",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_shop_related_videos",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-related-products/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Shop Related Products",
        "description": "Provider business records for TikTok Shop Related Products. Known row fields: id, tiktok_seller_product_product_id, tiktok_seller_product_product_name, tiktok_seller_product_product_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokShopRelatedProducts",
        "externalDocs": {
          "description": "Nexscope TikTok Shop Related Products documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-related-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Shop ID, preserved as a string.",
                    "minLength": 1,
                    "example": "7495205878591949358"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "7495205878591949358",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_id": {
                                            "description": "Source-documented tiktok_seller_product_product_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_name": {
                                            "description": "Source-documented tiktok_seller_product_product_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_product_link": {
                                            "description": "Source-documented tiktok_seller_detail_product_link; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_product_detail_link": {
                                            "description": "Source-documented tiktok_seller_detail_product_detail_link; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_region": {
                                            "description": "Source-documented tiktok_seller_product_region; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_status": {
                                            "description": "Source-documented tiktok_seller_product_product_status; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_l1_category": {
                                            "description": "Source-documented tiktok_seller_product_l1_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_l2_category": {
                                            "description": "Source-documented tiktok_seller_product_l2_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_l3_category": {
                                            "description": "Source-documented tiktok_seller_product_l3_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_create_time": {
                                            "description": "Source-documented tiktok_seller_product_create_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_sold_count": {
                                            "description": "Source-documented tiktok_seller_product_product_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_sold_count_for_last_7_days": {
                                            "description": "Source-documented tiktok_seller_product_product_sold_count_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_gmv": {
                                            "description": "Source-documented tiktok_seller_product_product_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_gmv_for_last_7_days": {
                                            "description": "Source-documented tiktok_seller_product_product_gmv_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_rating": {
                                            "description": "Source-documented tiktok_seller_product_product_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_review_count": {
                                            "description": "Source-documented tiktok_seller_product_review_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_commission_rate": {
                                            "description": "Source-documented tiktok_seller_product_commission_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_total_related_creator_count": {
                                            "description": "Source-documented tiktok_seller_product_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_total_related_video_count": {
                                            "description": "Source-documented tiktok_seller_product_total_related_video_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_floor_price": {
                                            "description": "Source-documented tiktok_seller_product_floor_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_ceiling_price": {
                                            "description": "Source-documented tiktok_seller_product_ceiling_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_images": {
                                            "description": "Source-documented tiktok_seller_product_product_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_skus": {
                                            "description": "Source-documented tiktok_seller_product_product_skus; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_product_product_sku_props": {
                                            "description": "Source-documented tiktok_seller_product_product_sku_props; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Shop Related Products. Known row fields: id, tiktok_seller_product_product_id, tiktok_seller_product_product_name, tiktok_seller_product_product_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "tiktok_seller_product_product_id": null,
                          "tiktok_seller_product_product_name": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-shop-related-products",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_shop_related_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-related-creators/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Shop Related Creators",
        "description": "Provider business records for TikTok Shop Related Creators. Known row fields: id, tiktok_seller_detail_creator_user_id, tiktok_seller_detail_creator_unique_id, tiktok_seller_detail_creator_nickname, tiktok_seller_detail_creator_follower_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokShopRelatedCreators",
        "externalDocs": {
          "description": "Nexscope TikTok Shop Related Creators documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-related-creators"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Shop ID, preserved as a string.",
                    "minLength": 1,
                    "example": "7495205878591949358"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "7495205878591949358",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_user_id": {
                                            "description": "Source-documented tiktok_seller_detail_creator_user_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_seller_id": {
                                            "description": "Source-documented tiktok_seller_detail_creator_seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_unique_id": {
                                            "description": "Source-documented tiktok_seller_detail_creator_unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_nickname": {
                                            "description": "Source-documented tiktok_seller_detail_creator_nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_country_code": {
                                            "description": "Source-documented tiktok_seller_detail_creator_country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_account_type": {
                                            "description": "Source-documented tiktok_seller_detail_creator_account_type; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_category_label": {
                                            "description": "Source-documented tiktok_seller_detail_creator_category_label; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_user_avatar": {
                                            "description": "Source-documented tiktok_seller_detail_creator_user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_youtube_channel_id": {
                                            "description": "Source-documented tiktok_seller_detail_creator_youtube_channel_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_follower_count": {
                                            "description": "Source-documented tiktok_seller_detail_creator_follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_total_favorited": {
                                            "description": "Source-documented tiktok_seller_detail_creator_total_favorited; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_video_count": {
                                            "description": "Source-documented tiktok_seller_detail_creator_video_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_related_total_video": {
                                            "description": "Source-documented tiktok_seller_detail_creator_related_total_video; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_author_avg_like_cnt": {
                                            "description": "Source-documented tiktok_seller_detail_creator_author_avg_like_cnt; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_author_avg_play_cnt": {
                                            "description": "Source-documented tiktok_seller_detail_creator_author_avg_play_cnt; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_author_total_play_cnt": {
                                            "description": "Source-documented tiktok_seller_detail_creator_author_total_play_cnt; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_author_avg_engagement_rate": {
                                            "description": "Source-documented tiktok_seller_detail_creator_author_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_by_live": {
                                            "description": "Source-documented tiktok_seller_detail_creator_by_live; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_by_shop": {
                                            "description": "Source-documented tiktok_seller_detail_creator_by_shop; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_by_video": {
                                            "description": "Source-documented tiktok_seller_detail_creator_by_video; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_video_7d_gmv": {
                                            "description": "Source-documented tiktok_seller_detail_creator_video_7d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_video_30d_gmv": {
                                            "description": "Source-documented tiktok_seller_detail_creator_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_live_7d_gmv": {
                                            "description": "Source-documented tiktok_seller_detail_live_7d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_live_30d_gmv": {
                                            "description": "Source-documented tiktok_seller_detail_creator_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_total_video_live_7d_gmv": {
                                            "description": "Source-documented tiktok_seller_detail_creator_total_video_live_7d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_total_video_live_30d_gmv": {
                                            "description": "Source-documented tiktok_seller_detail_creator_total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "tiktok_seller_detail_creator_bio_email": {
                                            "description": "Source-documented tiktok_seller_detail_creator_bio_email; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Shop Related Creators. Known row fields: id, tiktok_seller_detail_creator_user_id, tiktok_seller_detail_creator_unique_id, tiktok_seller_detail_creator_nickname, tiktok_seller_detail_creator_follower_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "tiktok_seller_detail_creator_user_id": null,
                          "tiktok_seller_detail_creator_seller_id": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-shop-related-creators",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_shop_related_creators",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-related-videos/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Related Videos",
        "description": "Provider business records for TikTok Product Related Videos. Video identity, author, timing, engagement and sales fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductRelatedVideos",
        "externalDocs": {
          "description": "Nexscope TikTok Product Related Videos documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-related-videos"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Product ID, preserved as a string.",
                    "minLength": 1,
                    "example": "1732052189676081387"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "1732052189676081387",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_id": {
                                            "description": "Source-documented video_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_desc": {
                                            "description": "Source-documented video_desc; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "share_url": {
                                            "description": "Source-documented share_url; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_cover": {
                                            "description": "Source-documented video_cover; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "author_id": {
                                            "description": "Source-documented author_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "author_unique_id": {
                                            "description": "Source-documented author_unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "author_nickname": {
                                            "description": "Source-documented author_nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_avatar": {
                                            "description": "Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_launch_time": {
                                            "description": "Source-documented video_launch_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_duration": {
                                            "description": "Source-documented video_duration; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_play_count": {
                                            "description": "Source-documented video_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_like_count": {
                                            "description": "Source-documented video_like_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_comment_count": {
                                            "description": "Source-documented video_comment_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_share_count": {
                                            "description": "Source-documented video_share_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_collect_count": {
                                            "description": "Source-documented video_collect_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_engagement_rate": {
                                            "description": "Source-documented video_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_30d_gmv": {
                                            "description": "Source-documented video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_30d_sold_count": {
                                            "description": "Source-documented video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "is_ad": {
                                            "description": "Source-documented is_ad; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "is_aigc_video": {
                                            "description": "Source-documented is_aigc_video; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product Related Videos. Known row fields: video_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "video_id": null,
                          "video_desc": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-related-videos",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_related_videos",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-reviews/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Reviews",
        "description": "Provider business records for TikTok Product Reviews. Review identity, text, rating, author, media and SKU fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductReviews",
        "externalDocs": {
          "description": "Nexscope TikTok Product Reviews documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-reviews"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Product ID, preserved as a string.",
                    "minLength": 1,
                    "example": "1732052189676081387"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "1732052189676081387",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "review_id": {
                                            "description": "Source-documented review_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "review_text": {
                                            "description": "Source-documented review_text; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "rating": {
                                            "description": "Source-documented rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "create_time": {
                                            "description": "Source-documented create_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "publish_time": {
                                            "description": "Source-documented publish_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_id": {
                                            "description": "Source-documented user_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_unique_id": {
                                            "description": "Source-documented user_unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_nickname": {
                                            "description": "Source-documented user_nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_avatar": {
                                            "description": "Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "review_images": {
                                            "description": "Source-documented review_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "review_videos": {
                                            "description": "Source-documented review_videos; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "sku_info": {
                                            "description": "Source-documented sku_info; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product Reviews. Known row fields: review_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "review_id": null,
                          "review_text": null,
                          "rating": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-reviews",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_reviews",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-related-lives/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Related Lives",
        "description": "Provider business records for TikTok Product Related Lives. Live identity, host, timing, audience and sales fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductRelatedLives",
        "externalDocs": {
          "description": "Nexscope TikTok Product Related Lives documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-related-lives"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Product ID, preserved as a string.",
                    "minLength": 1,
                    "example": "1732052189676081387"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "1732052189676081387",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "room_id": {
                                            "description": "Source-documented room_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "title": {
                                            "description": "Source-documented title; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "room_link": {
                                            "description": "Source-documented room_link; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_id": {
                                            "description": "Source-documented user_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_unique_id": {
                                            "description": "Source-documented user_unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_nickname": {
                                            "description": "Source-documented user_nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "country_code": {
                                            "description": "Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "start_time": {
                                            "description": "Source-documented start_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "end_time": {
                                            "description": "Source-documented end_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "gmv": {
                                            "description": "Source-documented gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "gpm": {
                                            "description": "Source-documented gpm; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "opm": {
                                            "description": "Source-documented opm; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_sold_count": {
                                            "description": "Source-documented total_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_count": {
                                            "description": "Source-documented product_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_user": {
                                            "description": "Source-documented total_user; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "max_user_count": {
                                            "description": "Source-documented max_user_count; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product Related Lives. Known row fields: room_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "room_id": null,
                          "title": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-related-lives",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_related_lives",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-related-creators/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Related Creators",
        "description": "Provider business records for TikTok Product Related Creators. Creator identity, audience, engagement, sales and contact fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductRelatedCreators",
        "externalDocs": {
          "description": "Nexscope TikTok Product Related Creators documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-related-creators"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "id": {
                    "type": "string",
                    "description": "Product ID, preserved as a string.",
                    "minLength": 1,
                    "example": "1732052189676081387"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "1732052189676081387",
                "page": 1,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_id": {
                                            "description": "Source-documented user_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "uid": {
                                            "description": "Source-documented uid; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "unique_id": {
                                            "description": "Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "nickname": {
                                            "description": "Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_avatar": {
                                            "description": "Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "follower_count": {
                                            "description": "Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_count": {
                                            "description": "Source-documented video_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "author_avg_engagement_rate": {
                                            "description": "Source-documented author_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_avg_play_count": {
                                            "description": "Source-documented video_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_avg_like_count": {
                                            "description": "Source-documented video_avg_like_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_30d_gmv": {
                                            "description": "Source-documented video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "video_30d_sold_count": {
                                            "description": "Source-documented video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "live_30d_gmv": {
                                            "description": "Source-documented live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "live_30d_sold_count": {
                                            "description": "Source-documented live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_video_live_30d_gmv": {
                                            "description": "Source-documented total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "total_video_live_30d_sold_count": {
                                            "description": "Source-documented total_video_live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "country_code": {
                                            "description": "Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "category_label": {
                                            "description": "Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "bio_email": {
                                            "description": "Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product Related Creators. Known row fields: user_id, uid, unique_id, nickname. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "user_id": null,
                          "uid": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-related-creators",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_related_creators",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creator Detail",
        "description": "Provider business records for TikTok Creator Detail. Base creator fields and optional core, channel, and portrait sections are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokCreatorDetail",
        "externalDocs": {
          "description": "Nexscope TikTok Creator Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "id": {
                    "type": "string",
                    "description": "Creator ID, preserved as a string.",
                    "minLength": 1,
                    "example": "7302162228386776110"
                  },
                  "include": {
                    "type": "string",
                    "description": "Comma-separated optional detail sections: core, channel, portrait.",
                    "pattern": "^(core|channel|portrait)(,(core|channel|portrait))*$",
                    "example": "core,channel,portrait"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "7302162228386776110",
                "include": "core,channel,portrait"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "ins_id": {
                                            "description": "Source-documented ins_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "nickname": {
                                            "description": "Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "unique_id": {
                                            "description": "Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "signature": {
                                            "description": "Source-documented signature; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "user_avatar": {
                                            "description": "Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "bio_url": {
                                            "description": "Source-documented bio_url; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "category_label": {
                                            "description": "Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_category_label_list": {
                                            "description": "Source-documented product_category_label_list; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "enterprise_verify_reason": {
                                            "description": "Source-documented enterprise_verify_reason; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "partnered_brand": {
                                            "description": "Source-documented partnered_brand; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "has_live_product": {
                                            "description": "Source-documented has_live_product; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "has_shop_product": {
                                            "description": "Source-documented has_shop_product; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "has_video_product": {
                                            "description": "Source-documented has_video_product; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "bio_email": {
                                            "description": "Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "facebook_url": {
                                            "description": "Source-documented facebook_url; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "youtube_channel_id": {
                                            "description": "Source-documented youtube_channel_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "last_update_time": {
                                            "description": "Source-documented last_update_time; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Creator Detail. Base creator fields and optional core, channel, and portrait sections are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "channel": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "total_count": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": [
                                              "object",
                                              "null"
                                            ],
                                            "properties": {
                                              "channel_country_code": {
                                                "description": "Source-documented channel_country_code; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_ec_video_30d_avg_engagement_rate": {
                                                "description": "Source-documented channel_ec_video_30d_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_ec_video_30d_avg_play_count": {
                                                "description": "Source-documented channel_ec_video_30d_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_live_30d_gmv": {
                                                "description": "Source-documented channel_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_live_30d_gpm": {
                                                "description": "Source-documented channel_live_30d_gpm; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_total_video_live_30d_gmv": {
                                                "description": "Source-documented channel_total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_uid": {
                                                "description": "Source-documented channel_uid; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_video_30d_gmv": {
                                                "description": "Source-documented channel_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_video_30d_gpm": {
                                                "description": "Source-documented channel_video_30d_gpm; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "id": {
                                                "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "description": "Optional channel detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.",
                                          "type": [
                                            "array",
                                            "null"
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "additionalProperties": true
                                },
                                "core": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "total_count": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": [
                                              "object",
                                              "null"
                                            ],
                                            "properties": {
                                              "core_author_avg_engagement_rate": {
                                                "description": "Source-documented core_author_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_follower_count": {
                                                "description": "Source-documented core_follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_product_count": {
                                                "description": "Source-documented core_product_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_total_favorited": {
                                                "description": "Source-documented core_total_favorited; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_uid": {
                                                "description": "Source-documented core_uid; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_video_total_like_count_to_follower_count": {
                                                "description": "Source-documented core_video_total_like_count_to_follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "id": {
                                                "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "tioktok_creator_detail_core_ec_video_count": {
                                                "description": "Source-documented tioktok_creator_detail_core_ec_video_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "tioktok_creator_detail_core_ecom_video_avg_play_count": {
                                                "description": "Source-documented tioktok_creator_detail_core_ecom_video_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "tioktok_creator_detail_core_med_commission_rate": {
                                                "description": "Source-documented tioktok_creator_detail_core_med_commission_rate; may be absent or null. Preserve the provider value and original monetary units."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "description": "Optional core detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.",
                                          "type": [
                                            "array",
                                            "null"
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "additionalProperties": true
                                },
                                "portrait": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "total_count": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": [
                                              "object",
                                              "null"
                                            ],
                                            "properties": {
                                              "id": {
                                                "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "portrait_age_distribution": {
                                                "description": "Source-documented portrait_age_distribution; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "portrait_follower_count": {
                                                "description": "Source-documented portrait_follower_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "portrait_gender_distribution": {
                                                "description": "Source-documented portrait_gender_distribution; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "portrait_region_distribution": {
                                                "description": "Source-documented portrait_region_distribution; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "portrait_uid": {
                                                "description": "Source-documented portrait_uid; may be absent or null. Preserve the provider value and original monetary units."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "description": "Optional portrait detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.",
                                          "type": [
                                            "array",
                                            "null"
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "additionalProperties": true
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "ins_id": null,
                          "nickname": null
                        }
                      ],
                      "channel": {
                        "items": [
                          {
                            "channel_country_code": null,
                            "channel_ec_video_30d_avg_engagement_rate": null,
                            "channel_ec_video_30d_avg_play_count": null
                          }
                        ]
                      },
                      "core": {
                        "items": [
                          {
                            "core_author_avg_engagement_rate": null,
                            "core_follower_count": null,
                            "core_product_count": null
                          }
                        ]
                      },
                      "portrait": {
                        "items": [
                          {
                            "id": null,
                            "portrait_age_distribution": null,
                            "portrait_follower_count": null
                          }
                        ]
                      }
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-creator-detail",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_creator_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Shop Detail",
        "description": "Provider business records for TikTok Shop Detail. Known row fields: id, seller_id, shop_name, region, shop_rating, shop_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokShopDetail",
        "externalDocs": {
          "description": "Nexscope TikTok Shop Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "id": {
                    "type": "string",
                    "description": "Shop ID, preserved as a string.",
                    "minLength": 1,
                    "example": "7495205878591949358"
                  },
                  "include": {
                    "type": "string",
                    "description": "Comma-separated optional detail sections: core, channel.",
                    "pattern": "^(core|channel)(,(core|channel))*$",
                    "example": "core,channel"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "7495205878591949358",
                "include": "core,channel"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_id": {
                                            "description": "Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_name": {
                                            "description": "Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "region": {
                                            "description": "Source-documented region; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_main_category": {
                                            "description": "Source-documented shop_main_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_rating": {
                                            "description": "Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_total_gmv": {
                                            "description": "Source-documented shop_total_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "business_info": {
                                            "description": "Source-documented business_info; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_avatar": {
                                            "description": "Source-documented seller_avatar; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "create_time": {
                                            "description": "Source-documented create_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "last_update_time": {
                                            "description": "Source-documented last_update_time; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "creator_user_id": {
                                            "description": "Source-documented creator_user_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "creator_user_name": {
                                            "description": "Source-documented creator_user_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "creator_nickname": {
                                            "description": "Source-documented creator_nickname; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "creator_role": {
                                            "description": "Source-documented creator_role; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Shop Detail. Known row fields: id, seller_id, shop_name, region, shop_rating, shop_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "channel": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "total_count": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": [
                                              "object",
                                              "null"
                                            ],
                                            "properties": {
                                              "id": {
                                                "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_seller_id": {
                                                "description": "Source-documented channel_seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_seller_sold_count_for_last_30_days": {
                                                "description": "Source-documented channel_seller_sold_count_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_seller_gmv_for_last_30_days": {
                                                "description": "Source-documented channel_seller_gmv_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_video_30d_sold_count": {
                                                "description": "Source-documented channel_video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_video_30d_gmv": {
                                                "description": "Source-documented channel_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_live_30d_sold_count": {
                                                "description": "Source-documented channel_live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_live_30d_gmv": {
                                                "description": "Source-documented channel_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_product_card_30d_sold_count": {
                                                "description": "Source-documented channel_product_card_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_product_card_30d_gmv": {
                                                "description": "Source-documented channel_product_card_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_personal_creator_30d_sold_count": {
                                                "description": "Source-documented channel_personal_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_personal_creator_30d_gmv": {
                                                "description": "Source-documented channel_personal_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_seller_creator_30d_sold_count": {
                                                "description": "Source-documented channel_seller_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "channel_seller_creator_30d_gmv": {
                                                "description": "Source-documented channel_seller_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "description": "Optional channel detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.",
                                          "type": [
                                            "array",
                                            "null"
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "additionalProperties": true
                                },
                                "core": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "total_count": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": [
                                              "object",
                                              "null"
                                            ],
                                            "properties": {
                                              "id": {
                                                "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_id": {
                                                "description": "Source-documented core_seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_region": {
                                                "description": "Source-documented core_region; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_shop_product_count": {
                                                "description": "Source-documented core_seller_shop_product_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_shop_total_product_count": {
                                                "description": "Source-documented core_seller_shop_total_product_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_shop_total_sold_count": {
                                                "description": "Source-documented core_shop_total_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_shop_total_gmv": {
                                                "description": "Source-documented core_seller_shop_total_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_sold_count_for_last_30_days": {
                                                "description": "Source-documented core_seller_sold_count_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_gmv_for_last_30_days": {
                                                "description": "Source-documented core_seller_gmv_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_total_related_creator_count": {
                                                "description": "Source-documented core_seller_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_total_related_live_creator_count": {
                                                "description": "Source-documented core_seller_total_related_live_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_total_related_video_creator_count": {
                                                "description": "Source-documented core_seller_total_related_video_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "core_seller_total_related_shop_creator_count": {
                                                "description": "Source-documented core_seller_total_related_shop_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "description": "Optional core detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.",
                                          "type": [
                                            "array",
                                            "null"
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "additionalProperties": true
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "seller_id": null,
                          "shop_name": null
                        }
                      ],
                      "channel": {
                        "items": [
                          {
                            "id": null,
                            "channel_seller_id": null,
                            "channel_seller_sold_count_for_last_30_days": null
                          }
                        ]
                      },
                      "core": {
                        "items": [
                          {
                            "id": null,
                            "core_seller_id": null,
                            "core_region": null
                          }
                        ]
                      }
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-shop-detail",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_shop_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Detail",
        "description": "Provider business records for TikTok Product Detail. Base product, optional core performance, and channel attribution fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductDetail",
        "externalDocs": {
          "description": "Nexscope TikTok Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "id": {
                    "type": "string",
                    "description": "Product ID, preserved as a string.",
                    "minLength": 1,
                    "example": "1732052189676081387"
                  },
                  "include": {
                    "type": "string",
                    "description": "Comma-separated optional detail sections: core, channel.",
                    "pattern": "^(core|channel)(,(core|channel))*$",
                    "example": "core,channel"
                  }
                },
                "required": [
                  "country",
                  "id"
                ]
              },
              "example": {
                "country": "us",
                "id": "1732052189676081387",
                "include": "core,channel"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_id": {
                                            "description": "Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_name": {
                                            "description": "Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_images": {
                                            "description": "Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "floor_price": {
                                            "description": "Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "ceiling_price": {
                                            "description": "Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_rating": {
                                            "description": "Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "review_count": {
                                            "description": "Source-documented review_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_sold_count": {
                                            "description": "Source-documented product_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_gmv": {
                                            "description": "Source-documented product_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_sku_props": {
                                            "description": "Source-documented product_sku_props; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_skus": {
                                            "description": "Source-documented product_skus; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_l1_category": {
                                            "description": "Source-documented product_l1_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_l2_category": {
                                            "description": "Source-documented product_l2_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_l3_category": {
                                            "description": "Source-documented product_l3_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_name": {
                                            "description": "Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_id": {
                                            "description": "Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "region": {
                                            "description": "Source-documented region; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_status": {
                                            "description": "Source-documented product_status; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_type": {
                                            "description": "Source-documented seller_type; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "commission_rate": {
                                            "description": "Source-documented commission_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product Detail. Known row fields: id, product_id, product_name, product_images. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "channel": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "total_count": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": [
                                              "object",
                                              "null"
                                            ],
                                            "properties": {
                                              "id": {
                                                "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "video_30d_gmv": {
                                                "description": "Source-documented video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "video_30d_sold_count": {
                                                "description": "Source-documented video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "live_30d_gmv": {
                                                "description": "Source-documented live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "live_30d_sold_count": {
                                                "description": "Source-documented live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_card_30d_gmv": {
                                                "description": "Source-documented product_card_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_card_30d_sold_count": {
                                                "description": "Source-documented product_card_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "personal_creator_30d_gmv": {
                                                "description": "Source-documented personal_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "personal_creator_30d_sold_count": {
                                                "description": "Source-documented personal_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "seller_creator_30d_gmv": {
                                                "description": "Source-documented seller_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "seller_creator_30d_sold_count": {
                                                "description": "Source-documented seller_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "description": "Optional channel detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.",
                                          "type": [
                                            "array",
                                            "null"
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "additionalProperties": true
                                },
                                "core": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "total_count": {
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    "items": {
                                      "anyOf": [
                                        {
                                          "items": {
                                            "type": [
                                              "object",
                                              "null"
                                            ],
                                            "properties": {
                                              "id": {
                                                "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_gmv": {
                                                "description": "Source-documented product_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_sold_count": {
                                                "description": "Source-documented product_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_gmv_30d": {
                                                "description": "Source-documented product_gmv_30d; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_sold_count_30d": {
                                                "description": "Source-documented product_sold_count_30d; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_gmv_7d": {
                                                "description": "Source-documented product_gmv_7d; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_sold_count_7d": {
                                                "description": "Source-documented product_sold_count_7d; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_ad_gmv": {
                                                "description": "Source-documented product_ad_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_ad_sold_count": {
                                                "description": "Source-documented product_ad_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_video_gmv": {
                                                "description": "Source-documented product_video_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_video_sold_count": {
                                                "description": "Source-documented product_video_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_live_gmv": {
                                                "description": "Source-documented product_live_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "product_live_sold_count": {
                                                "description": "Source-documented product_live_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "related_creator_count": {
                                                "description": "Source-documented related_creator_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "related_live_count": {
                                                "description": "Source-documented related_live_count; may be absent or null. Preserve the provider value and original monetary units."
                                              },
                                              "related_video_count": {
                                                "description": "Source-documented related_video_count; may be absent or null. Preserve the provider value and original monetary units."
                                              }
                                            },
                                            "additionalProperties": true
                                          },
                                          "description": "Optional core detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.",
                                          "type": [
                                            "array",
                                            "null"
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "additionalProperties": true
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "product_id": null,
                          "product_name": null
                        }
                      ],
                      "channel": {
                        "items": [
                          {
                            "id": null,
                            "video_30d_gmv": null,
                            "video_30d_sold_count": null
                          }
                        ]
                      },
                      "core": {
                        "items": [
                          {
                            "id": null,
                            "product_gmv": null,
                            "product_sold_count": null
                          }
                        ]
                      }
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/chuhaijiang-tiktok-product-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Market Search",
        "description": "Provider business records for TikTok Product Market Search. Product identity, pricing, sales, seller, category, and SKU fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
        "operationId": "runChuhaijiangTiktokProductSearch",
        "externalDocs": {
          "description": "Nexscope TikTok Product Search documentation",
          "url": "https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "type": "string",
                    "description": "Lowercase TikTok market code.",
                    "enum": [
                      "br",
                      "de",
                      "es",
                      "fr",
                      "gb",
                      "id",
                      "it",
                      "jp",
                      "mx",
                      "my",
                      "ph",
                      "sg",
                      "th",
                      "us",
                      "vn"
                    ],
                    "example": "us"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting at 1.",
                    "minimum": 1,
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum records per page.",
                    "minimum": 1,
                    "maximum": 10,
                    "example": 5
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Product search keyword.",
                    "example": "beauty"
                  },
                  "category": {
                    "type": "string",
                    "description": "Product category ID."
                  },
                  "sellerType": {
                    "type": "string",
                    "description": "Seller type: 1 overseas non-brand, 2 local, 3 brand, 4 non-brand.",
                    "enum": [
                      "1",
                      "2",
                      "3",
                      "4"
                    ],
                    "example": "2"
                  },
                  "freeShipping": {
                    "type": "boolean",
                    "description": "Filter by free shipping availability.",
                    "example": true
                  },
                  "sort": {
                    "type": "string",
                    "description": "Provider sort field and direction (field:asc or field:desc).",
                    "default": "gmv_7d:desc",
                    "pattern": "^(daily_sold|gmv_30d|gmv_7d|price|rating|sold_30d|sold_7d):(asc|desc)$",
                    "example": "gmv_7d:desc"
                  },
                  "minPrice": {
                    "type": "number",
                    "description": "Minimum price in USD."
                  },
                  "maxPrice": {
                    "type": "number",
                    "description": "Maximum price in USD."
                  },
                  "minRating": {
                    "type": "number",
                    "description": "Minimum product rating.",
                    "minimum": 0,
                    "maximum": 5
                  },
                  "maxRating": {
                    "type": "number",
                    "description": "Maximum product rating.",
                    "minimum": 0,
                    "maximum": 5
                  },
                  "minSold7d": {
                    "type": "number",
                    "description": "Minimum 7-day sales."
                  },
                  "maxSold7d": {
                    "type": "number",
                    "description": "Maximum 7-day sales."
                  },
                  "minSold30d": {
                    "type": "number",
                    "description": "Minimum 30-day sales."
                  },
                  "maxSold30d": {
                    "type": "number",
                    "description": "Maximum 30-day sales."
                  }
                },
                "required": [
                  "country"
                ]
              },
              "example": {
                "country": "us",
                "keyword": "beauty",
                "minRating": 4,
                "freeShipping": true,
                "pageSize": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "request_id": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "properties": {
                                "items": {
                                  "anyOf": [
                                    {
                                      "items": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "properties": {
                                          "id": {
                                            "description": "Source-documented id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_id": {
                                            "description": "Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_name": {
                                            "description": "Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_images": {
                                            "description": "Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "floor_price": {
                                            "description": "Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "ceiling_price": {
                                            "description": "Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_rating": {
                                            "description": "Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "review_count": {
                                            "description": "Source-documented review_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_sold_count": {
                                            "description": "Source-documented product_sold_count; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_sold_count_for_last_7_days": {
                                            "description": "Source-documented product_sold_count_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_sold_count_for_last_30_days": {
                                            "description": "Source-documented product_sold_count_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_gmv": {
                                            "description": "Source-documented product_gmv; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_gmv_for_last_7_days": {
                                            "description": "Source-documented product_gmv_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_gmv_for_last_30_days": {
                                            "description": "Source-documented product_gmv_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "country_code": {
                                            "description": "Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "region": {
                                            "description": "Source-documented region; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_id": {
                                            "description": "Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "shop_name": {
                                            "description": "Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_status": {
                                            "description": "Source-documented product_status; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "seller_type": {
                                            "description": "Source-documented seller_type; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_l1_category": {
                                            "description": "Source-documented product_l1_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_l2_category": {
                                            "description": "Source-documented product_l2_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_l3_category": {
                                            "description": "Source-documented product_l3_category; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "commission_rate": {
                                            "description": "Source-documented commission_rate; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "free_shipping": {
                                            "description": "Source-documented free_shipping; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_sku_props": {
                                            "description": "Source-documented product_sku_props; may be absent or null. Preserve the provider value and original monetary units."
                                          },
                                          "product_skus": {
                                            "description": "Source-documented product_skus; may be absent or null. Preserve the provider value and original monetary units."
                                          }
                                        },
                                        "additionalProperties": true
                                      },
                                      "description": "Provider business records for TikTok Product Market Search. Known row fields: id, product_name, product_images, floor_price, ceiling_price, product_rating, product_sold_count, product_gmv, seller_id, shop_name. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.",
                                      "type": [
                                        "array",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "total_count": {
                                  "anyOf": [
                                    {
                                      "description": "Total matching records.",
                                      "type": [
                                        "integer",
                                        "null"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {
                      "items": [
                        {
                          "id": null,
                          "product_id": null,
                          "product_name": null
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "chuhaijiang-tiktok-product-search",
        "x-nexscope-mcp-tool-name": "nexscope_chuhaijiang_tiktok_product_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/geekbi-temu-goods-image-search/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Nexscope Temu Image Search",
        "description": "Execute the selected image search operation and preserve provider business fields and extensions.",
        "operationId": "runGeekbiTemuGoodsImageSearch",
        "externalDocs": {
          "description": "Nexscope Temu Image Search documentation",
          "url": "https://www.nexscope.ai/api-docs/geekbi-temu-goods-image-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Provider OSS temporary image URL, obtained through presignedPut and a successful PUT upload with the signature query removed. Replace the example.invalid placeholder before calling; external URLs are rejected upstream. Actual image must be at most 10 MB and JPEG, PNG, GIF, WebP or BMP.",
                    "minLength": 1,
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "contentType": {
                    "type": "string",
                    "description": "Must match OSS response and actual image bytes; omitted means server detection.",
                    "maxLength": 100,
                    "enum": [
                      "image/jpeg",
                      "image/png",
                      "image/gif",
                      "image/webp",
                      "image/bmp"
                    ]
                  }
                },
                "required": [
                  "imageUrl"
                ]
              },
              "example": {
                "imageUrl": "https://example.invalid/replace-with-provider-oss-image",
                "contentType": "image/jpeg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "columns": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Render column definitions; business records are separate.",
                                  "items": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: title."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: type."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceTool."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceType."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "items": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Returned records, including valid empty results; preserve duplicate records and unknown fields.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "isAd": {
                                        "type": [
                                          "boolean",
                                          "null"
                                        ],
                                        "description": "Provider product flag: isAd."
                                      },
                                      "isCustom": {
                                        "type": [
                                          "boolean",
                                          "null"
                                        ],
                                        "description": "Provider product flag: isCustom."
                                      },
                                      "isPresale": {
                                        "type": [
                                          "boolean",
                                          "null"
                                        ],
                                        "description": "Provider product flag: isPresale."
                                      },
                                      "goodsId": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider goodsId; preserve identifier and timestamp strings."
                                      },
                                      "mallId": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider mallId; preserve identifier and timestamp strings."
                                      },
                                      "thumbnail": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider thumbnail; preserve identifier and timestamp strings."
                                      },
                                      "goodsName": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider goodsName; preserve identifier and timestamp strings."
                                      },
                                      "goodsNameCn": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider goodsNameCn; preserve identifier and timestamp strings."
                                      },
                                      "goodsNameEn": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider goodsNameEn; preserve identifier and timestamp strings."
                                      },
                                      "brand": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider brand; preserve identifier and timestamp strings."
                                      },
                                      "sku": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider sku; preserve identifier and timestamp strings."
                                      },
                                      "onSaleTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider onSaleTime; preserve identifier and timestamp strings."
                                      },
                                      "mallOpenTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider mallOpenTime; preserve identifier and timestamp strings."
                                      },
                                      "createTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider createTime; preserve identifier and timestamp strings."
                                      },
                                      "updateTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider updateTime; preserve identifier and timestamp strings."
                                      },
                                      "sold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider sold; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "quantity": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider quantity; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "mallSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider mallSold; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "sales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider sales; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "minPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider minPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "maxPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider maxPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "supplyPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider supplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "minSupplyPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider minSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "medianSupplyPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider medianSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "maxSupplyPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider maxSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "goodsScore": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider goodsScore; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "reviewNum": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider reviewNum; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "hostingMode": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider hostingMode; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "status": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider status; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "similarNum": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider similarNum; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "catIds": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "description": "Associated category identifiers.",
                                        "items": {}
                                      },
                                      "catItems": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "description": "Category paths: catId, catName, catLevel, parentCatId and isLeaf.",
                                        "items": {}
                                      },
                                      "daySold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sold metric; sales revenue uses site currency."
                                      },
                                      "daySoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sold."
                                      },
                                      "daySales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sales metric; sales revenue uses site currency."
                                      },
                                      "daySalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sales."
                                      },
                                      "weekSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sold metric; sales revenue uses site currency."
                                      },
                                      "weekSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sold."
                                      },
                                      "weekSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sales metric; sales revenue uses site currency."
                                      },
                                      "weekSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sales."
                                      },
                                      "monthSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sold metric; sales revenue uses site currency."
                                      },
                                      "monthSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sold."
                                      },
                                      "monthSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sales metric; sales revenue uses site currency."
                                      },
                                      "monthSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sales."
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Provider match count, possibly capped at 10000 for searches."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "columns": [],
                    "items": [],
                    "total": 0
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "geekbi-temu-goods-image-search",
        "x-nexscope-mcp-tool-name": "nexscope_geekbi_temu_goods_image_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/geekbi-temu-mall-search/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Nexscope Temu Shop Search",
        "description": "Execute the selected shop search operation and preserve provider business fields and extensions.",
        "operationId": "runGeekbiTemuMallSearch",
        "externalDocs": {
          "description": "Nexscope Temu Shop Search documentation",
          "url": "https://www.nexscope.ai/api-docs/geekbi-temu-mall-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "regionId": {
                    "type": "integer",
                    "description": "Temu region from sites[].regionId; never siteId.",
                    "minimum": 1,
                    "default": 211
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number.",
                    "minimum": 1,
                    "default": 1
                  },
                  "size": {
                    "type": "integer",
                    "description": "Items per page; page times size must not exceed 10000.",
                    "minimum": 1,
                    "maximum": 200,
                    "default": 20
                  },
                  "keyword": {
                    "type": "string",
                    "description": "User keyword; preserve the supplied language.",
                    "maxLength": 300
                  },
                  "sort": {
                    "type": "string",
                    "description": "Confirmed provider sort field; omit when unnecessary.",
                    "maxLength": 100
                  },
                  "order": {
                    "type": "string",
                    "description": "Sort direction, case-insensitive.",
                    "pattern": "^([aA][sS][cC]|[dD][eE][sS][cC])$"
                  },
                  "catIds": {
                    "type": "array",
                    "description": "Category identifiers obtained from category lookup.",
                    "items": {
                      "type": "integer",
                      "minimum": 0
                    }
                  },
                  "hostingMode": {
                    "type": "integer",
                    "description": "1 fully managed, 2 semi-managed.",
                    "enum": [
                      1,
                      2
                    ]
                  },
                  "mallSoldMin": {
                    "type": "integer",
                    "description": "Lower bound for mallSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallSoldMax": {
                    "type": "integer",
                    "description": "Upper bound for mallSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "reviewNumMin": {
                    "type": "integer",
                    "description": "Lower bound for reviewNum; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "reviewNumMax": {
                    "type": "integer",
                    "description": "Upper bound for reviewNum; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "goodsNumMin": {
                    "type": "integer",
                    "description": "Lower bound for goodsNum; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "goodsNumMax": {
                    "type": "integer",
                    "description": "Upper bound for goodsNum; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "followerNumMin": {
                    "type": "integer",
                    "description": "Lower bound for followerNum; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "followerNumMax": {
                    "type": "integer",
                    "description": "Upper bound for followerNum; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallSalesMin": {
                    "type": "number",
                    "description": "Lower bound for mallSales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallSalesMax": {
                    "type": "number",
                    "description": "Upper bound for mallSales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "avgPriceMin": {
                    "type": "number",
                    "description": "Lower bound for avgPrice; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "avgPriceMax": {
                    "type": "number",
                    "description": "Upper bound for avgPrice; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallStarMin": {
                    "type": "number",
                    "description": "Lower bound for mallStar; minimum must not exceed maximum.",
                    "minimum": 0,
                    "maximum": 5
                  },
                  "mallStarMax": {
                    "type": "number",
                    "description": "Upper bound for mallStar; minimum must not exceed maximum.",
                    "minimum": 0,
                    "maximum": 5
                  },
                  "mallOpenTimeMin": {
                    "type": "string",
                    "description": "Earliest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum.",
                    "maxLength": 40,
                    "format": "date-time"
                  },
                  "mallOpenTimeMax": {
                    "type": "string",
                    "description": "Latest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum.",
                    "maxLength": 40,
                    "format": "date-time"
                  }
                },
                "required": []
              },
              "example": {
                "regionId": 211,
                "page": 1,
                "size": 3,
                "mallStarMin": 4
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "columns": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Render column definitions; business records are separate.",
                                  "items": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: title."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: type."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceTool."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceType."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "items": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Returned records, including valid empty results; preserve duplicate records and unknown fields.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider id; preserve identifier and timestamp strings."
                                      },
                                      "mallId": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider mallId; preserve identifier and timestamp strings."
                                      },
                                      "mallLogo": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider mallLogo; preserve identifier and timestamp strings."
                                      },
                                      "mallName": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider mallName; preserve identifier and timestamp strings."
                                      },
                                      "mallOpenTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider mallOpenTime; preserve identifier and timestamp strings."
                                      },
                                      "createTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider createTime; preserve identifier and timestamp strings."
                                      },
                                      "updateTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider updateTime; preserve identifier and timestamp strings."
                                      },
                                      "regionId": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider regionId; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "hot": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider hot; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "mallStar": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider mallStar; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "reviewNum": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider reviewNum; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "goodsNum": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider goodsNum; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "followerNum": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider followerNum; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "mallSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider mallSold; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "mallSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider mallSales; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "avgPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider avgPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "hostingMode": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider hostingMode; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "catIds": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "description": "Associated category identifiers.",
                                        "items": {}
                                      },
                                      "catItems": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "description": "Category paths: catId, catName, catLevel, parentCatId and isLeaf.",
                                        "items": {}
                                      },
                                      "dayFollower": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Follower metric; sales revenue uses site currency."
                                      },
                                      "dayFollowerRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Follower."
                                      },
                                      "dayItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day ItemCount metric; sales revenue uses site currency."
                                      },
                                      "dayItemCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day ItemCount."
                                      },
                                      "daySales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sales metric; sales revenue uses site currency."
                                      },
                                      "daySalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sales."
                                      },
                                      "daySellthroughCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day SellthroughCount metric; sales revenue uses site currency."
                                      },
                                      "daySellthroughCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day SellthroughCount."
                                      },
                                      "daySold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sold metric; sales revenue uses site currency."
                                      },
                                      "daySoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sold."
                                      },
                                      "weekFollower": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Follower metric; sales revenue uses site currency."
                                      },
                                      "weekFollowerRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Follower."
                                      },
                                      "weekItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week ItemCount metric; sales revenue uses site currency."
                                      },
                                      "weekItemCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week ItemCount."
                                      },
                                      "weekSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sales metric; sales revenue uses site currency."
                                      },
                                      "weekSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sales."
                                      },
                                      "weekSellthroughCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week SellthroughCount metric; sales revenue uses site currency."
                                      },
                                      "weekSellthroughCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week SellthroughCount."
                                      },
                                      "weekSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sold metric; sales revenue uses site currency."
                                      },
                                      "weekSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sold."
                                      },
                                      "monthFollower": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Follower metric; sales revenue uses site currency."
                                      },
                                      "monthFollowerRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Follower."
                                      },
                                      "monthItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month ItemCount metric; sales revenue uses site currency."
                                      },
                                      "monthItemCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month ItemCount."
                                      },
                                      "monthSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sales metric; sales revenue uses site currency."
                                      },
                                      "monthSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sales."
                                      },
                                      "monthSellthroughCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month SellthroughCount metric; sales revenue uses site currency."
                                      },
                                      "monthSellthroughCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month SellthroughCount."
                                      },
                                      "monthSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sold metric; sales revenue uses site currency."
                                      },
                                      "monthSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sold."
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Provider match count, possibly capped at 10000 for searches."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "regionId": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Region used for the query."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Current page."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "size": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Items per page."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "columns": [],
                    "items": [],
                    "total": 0,
                    "regionId": 211,
                    "page": 1,
                    "size": 3
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "geekbi-temu-mall-search",
        "x-nexscope-mcp-tool-name": "nexscope_geekbi_temu_mall_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/geekbi-temu-goods-detail/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Nexscope Temu Product Detail",
        "description": "Execute the selected product detail operation and preserve provider business fields and extensions.",
        "operationId": "runGeekbiTemuGoodsDetail",
        "externalDocs": {
          "description": "Nexscope Temu Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/geekbi-temu-goods-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "goodsId": {
                    "type": "string",
                    "description": "Product ID returned by product search.",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "regionId": {
                    "type": "integer",
                    "description": "Temu region from sites[].regionId; never siteId.",
                    "minimum": 1,
                    "default": 211
                  }
                },
                "required": [
                  "goodsId"
                ]
              },
              "example": {
                "goodsId": "601100240999226",
                "regionId": 211
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "columns": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Render column definitions; business records are separate.",
                                  "items": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: title."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: type."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceTool."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceType."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "goods": {
                              "anyOf": [
                                {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "description": "Product object; nullable fields and extensions are preserved.",
                                  "properties": {
                                    "isAd": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "boolean",
                                            "null"
                                          ],
                                          "description": "Provider product flag: isAd."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "isCustom": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "boolean",
                                            "null"
                                          ],
                                          "description": "Provider product flag: isCustom."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "isPresale": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "boolean",
                                            "null"
                                          ],
                                          "description": "Provider product flag: isPresale."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "goodsId": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider goodsId; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "mallId": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider mallId; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "thumbnail": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider thumbnail; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "goodsName": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider goodsName; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "goodsNameCn": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider goodsNameCn; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "goodsNameEn": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider goodsNameEn; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "brand": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider brand; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "sku": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider sku; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "onSaleTime": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider onSaleTime; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "mallOpenTime": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider mallOpenTime; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "createTime": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider createTime; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "updateTime": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "Provider updateTime; preserve identifier and timestamp strings."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "sold": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider sold; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "quantity": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider quantity; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "mallSold": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider mallSold; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "sales": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider sales; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "minPrice": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider minPrice; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "maxPrice": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider maxPrice; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "supplyPrice": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider supplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "minSupplyPrice": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider minSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "medianSupplyPrice": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider medianSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "maxSupplyPrice": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider maxSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "goodsScore": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider goodsScore; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "reviewNum": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider reviewNum; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "hostingMode": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider hostingMode; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "status": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider status; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "similarNum": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider similarNum; monetary values use the selected site's currency unless identified as supply prices."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "catIds": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "array",
                                            "null"
                                          ],
                                          "description": "Associated category identifiers.",
                                          "items": {}
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "catItems": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "array",
                                            "null"
                                          ],
                                          "description": "Category paths: catId, catName, catLevel, parentCatId and isLeaf.",
                                          "items": {}
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "daySold": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider day Sold metric; sales revenue uses site currency."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "daySoldRate": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider growth rate for day Sold."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "daySales": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider day Sales metric; sales revenue uses site currency."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "daySalesRate": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider growth rate for day Sales."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "weekSold": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider week Sold metric; sales revenue uses site currency."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "weekSoldRate": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider growth rate for week Sold."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "weekSales": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider week Sales metric; sales revenue uses site currency."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "weekSalesRate": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider growth rate for week Sales."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "monthSold": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider month Sold metric; sales revenue uses site currency."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "monthSoldRate": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider growth rate for month Sold."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "monthSales": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider month Sales metric; sales revenue uses site currency."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "monthSalesRate": {
                                      "anyOf": [
                                        {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "description": "Provider growth rate for month Sales."
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "history": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "History records from the last 30 days; optional provider metrics and time strings.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "sold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical sold; monetary values use site currency."
                                      },
                                      "sales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical sales; monetary values use site currency."
                                      },
                                      "minPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical minPrice; monetary values use site currency."
                                      },
                                      "maxPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical maxPrice; monetary values use site currency."
                                      },
                                      "quantity": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical quantity; monetary values use site currency."
                                      },
                                      "goodsScore": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical goodsScore; monetary values use site currency."
                                      },
                                      "reviewNum": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical reviewNum; monetary values use site currency."
                                      },
                                      "daySold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical daySold; monetary values use site currency."
                                      },
                                      "weekSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical weekSold; monetary values use site currency."
                                      },
                                      "monthSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical monthSold; monetary values use site currency."
                                      },
                                      "daySales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical daySales; monetary values use site currency."
                                      },
                                      "weekSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical weekSales; monetary values use site currency."
                                      },
                                      "monthSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical monthSales; monetary values use site currency."
                                      },
                                      "daySoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical daySoldRate; monetary values use site currency."
                                      },
                                      "weekSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical weekSoldRate; monetary values use site currency."
                                      },
                                      "monthSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical monthSoldRate; monetary values use site currency."
                                      },
                                      "daySalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical daySalesRate; monetary values use site currency."
                                      },
                                      "weekSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical weekSalesRate; monetary values use site currency."
                                      },
                                      "monthSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Historical monthSalesRate; monetary values use site currency."
                                      },
                                      "createTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Unmodified provider history timestamp."
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "regionId": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Region used for the query."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "columns": [],
                    "goods": {},
                    "history": [],
                    "regionId": 211
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "geekbi-temu-goods-detail",
        "x-nexscope-mcp-tool-name": "nexscope_geekbi_temu_goods_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/geekbi-temu-goods-search/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Nexscope Temu Product Search",
        "description": "Execute the selected product search operation and preserve provider business fields and extensions.",
        "operationId": "runGeekbiTemuGoodsSearch",
        "externalDocs": {
          "description": "Nexscope Temu Product Search documentation",
          "url": "https://www.nexscope.ai/api-docs/geekbi-temu-goods-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "regionId": {
                    "type": "integer",
                    "description": "Temu region from sites[].regionId; never siteId.",
                    "minimum": 1,
                    "default": 211
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number.",
                    "minimum": 1,
                    "default": 1
                  },
                  "size": {
                    "type": "integer",
                    "description": "Items per page; page times size must not exceed 10000.",
                    "minimum": 1,
                    "maximum": 200,
                    "default": 20
                  },
                  "keyword": {
                    "type": "string",
                    "description": "User keyword; preserve the supplied language.",
                    "maxLength": 300
                  },
                  "sort": {
                    "type": "string",
                    "description": "Confirmed provider sort field; omit when unnecessary.",
                    "maxLength": 100
                  },
                  "order": {
                    "type": "string",
                    "description": "Sort direction, case-insensitive.",
                    "pattern": "^([aA][sS][cC]|[dD][eE][sS][cC])$"
                  },
                  "catIds": {
                    "type": "array",
                    "description": "Category identifiers obtained from category lookup.",
                    "items": {
                      "type": "integer",
                      "minimum": 0
                    }
                  },
                  "matchMode": {
                    "type": "integer",
                    "description": "1 strict matching, 2 fuzzy matching.",
                    "enum": [
                      1,
                      2
                    ],
                    "default": 2
                  },
                  "status": {
                    "type": "array",
                    "description": "1 normal, 2 out of stock, 3 delisted.",
                    "items": {
                      "type": "integer",
                      "enum": [
                        1,
                        2,
                        3
                      ]
                    }
                  },
                  "hostingMode": {
                    "type": "integer",
                    "description": "1 fully managed, 2 semi-managed.",
                    "enum": [
                      1,
                      2
                    ]
                  },
                  "soldMin": {
                    "type": "integer",
                    "description": "Lower bound for sold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "soldMax": {
                    "type": "integer",
                    "description": "Upper bound for sold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "daySoldMin": {
                    "type": "integer",
                    "description": "Lower bound for daySold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "daySoldMax": {
                    "type": "integer",
                    "description": "Upper bound for daySold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "weekSoldMin": {
                    "type": "integer",
                    "description": "Lower bound for weekSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "weekSoldMax": {
                    "type": "integer",
                    "description": "Upper bound for weekSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "monthSoldMin": {
                    "type": "integer",
                    "description": "Lower bound for monthSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "monthSoldMax": {
                    "type": "integer",
                    "description": "Upper bound for monthSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "quantityMin": {
                    "type": "integer",
                    "description": "Lower bound for quantity; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "quantityMax": {
                    "type": "integer",
                    "description": "Upper bound for quantity; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallSoldMin": {
                    "type": "integer",
                    "description": "Lower bound for mallSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallSoldMax": {
                    "type": "integer",
                    "description": "Upper bound for mallSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "reviewNumMin": {
                    "type": "integer",
                    "description": "Lower bound for reviewNum; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "reviewNumMax": {
                    "type": "integer",
                    "description": "Upper bound for reviewNum; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "salesMin": {
                    "type": "number",
                    "description": "Lower bound for sales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "salesMax": {
                    "type": "number",
                    "description": "Upper bound for sales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "daySalesMin": {
                    "type": "number",
                    "description": "Lower bound for daySales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "daySalesMax": {
                    "type": "number",
                    "description": "Upper bound for daySales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "weekSalesMin": {
                    "type": "number",
                    "description": "Lower bound for weekSales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "weekSalesMax": {
                    "type": "number",
                    "description": "Upper bound for weekSales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "monthSalesMin": {
                    "type": "number",
                    "description": "Lower bound for monthSales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "monthSalesMax": {
                    "type": "number",
                    "description": "Upper bound for monthSales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "priceMin": {
                    "type": "number",
                    "description": "Lower bound for price; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "priceMax": {
                    "type": "number",
                    "description": "Upper bound for price; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "supplyPriceMin": {
                    "type": "number",
                    "description": "Lower bound for supplyPrice; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "supplyPriceMax": {
                    "type": "number",
                    "description": "Upper bound for supplyPrice; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "daySoldRateMin": {
                    "type": "number",
                    "description": "Lower bound for daySoldRate; minimum must not exceed maximum."
                  },
                  "daySoldRateMax": {
                    "type": "number",
                    "description": "Upper bound for daySoldRate; minimum must not exceed maximum."
                  },
                  "weekSoldRateMin": {
                    "type": "number",
                    "description": "Lower bound for weekSoldRate; minimum must not exceed maximum."
                  },
                  "weekSoldRateMax": {
                    "type": "number",
                    "description": "Upper bound for weekSoldRate; minimum must not exceed maximum."
                  },
                  "monthSoldRateMin": {
                    "type": "number",
                    "description": "Lower bound for monthSoldRate; minimum must not exceed maximum."
                  },
                  "monthSoldRateMax": {
                    "type": "number",
                    "description": "Upper bound for monthSoldRate; minimum must not exceed maximum."
                  },
                  "daySalesRateMin": {
                    "type": "number",
                    "description": "Lower bound for daySalesRate; minimum must not exceed maximum."
                  },
                  "daySalesRateMax": {
                    "type": "number",
                    "description": "Upper bound for daySalesRate; minimum must not exceed maximum."
                  },
                  "weekSalesRateMin": {
                    "type": "number",
                    "description": "Lower bound for weekSalesRate; minimum must not exceed maximum."
                  },
                  "weekSalesRateMax": {
                    "type": "number",
                    "description": "Upper bound for weekSalesRate; minimum must not exceed maximum."
                  },
                  "monthSalesRateMin": {
                    "type": "number",
                    "description": "Lower bound for monthSalesRate; minimum must not exceed maximum."
                  },
                  "monthSalesRateMax": {
                    "type": "number",
                    "description": "Upper bound for monthSalesRate; minimum must not exceed maximum."
                  },
                  "goodsScoreMin": {
                    "type": "number",
                    "description": "Lower bound for goodsScore; minimum must not exceed maximum.",
                    "minimum": 0,
                    "maximum": 5
                  },
                  "goodsScoreMax": {
                    "type": "number",
                    "description": "Upper bound for goodsScore; minimum must not exceed maximum.",
                    "minimum": 0,
                    "maximum": 5
                  },
                  "onSaleTimeMin": {
                    "type": "string",
                    "description": "Earliest onSaleTime in ISO-8601 date-time; minimum must not exceed maximum.",
                    "maxLength": 40,
                    "format": "date-time"
                  },
                  "onSaleTimeMax": {
                    "type": "string",
                    "description": "Latest onSaleTime in ISO-8601 date-time; minimum must not exceed maximum.",
                    "maxLength": 40,
                    "format": "date-time"
                  },
                  "mallOpenTimeMin": {
                    "type": "string",
                    "description": "Earliest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum.",
                    "maxLength": 40,
                    "format": "date-time"
                  },
                  "mallOpenTimeMax": {
                    "type": "string",
                    "description": "Latest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum.",
                    "maxLength": 40,
                    "format": "date-time"
                  }
                },
                "required": []
              },
              "example": {
                "regionId": 211,
                "page": 1,
                "size": 3,
                "keyword": "dress"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "columns": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Render column definitions; business records are separate.",
                                  "items": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: title."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: type."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceTool."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceType."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "items": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Returned records, including valid empty results; preserve duplicate records and unknown fields.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "isAd": {
                                        "type": [
                                          "boolean",
                                          "null"
                                        ],
                                        "description": "Provider product flag: isAd."
                                      },
                                      "isCustom": {
                                        "type": [
                                          "boolean",
                                          "null"
                                        ],
                                        "description": "Provider product flag: isCustom."
                                      },
                                      "isPresale": {
                                        "type": [
                                          "boolean",
                                          "null"
                                        ],
                                        "description": "Provider product flag: isPresale."
                                      },
                                      "goodsId": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider goodsId; preserve identifier and timestamp strings."
                                      },
                                      "mallId": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider mallId; preserve identifier and timestamp strings."
                                      },
                                      "thumbnail": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider thumbnail; preserve identifier and timestamp strings."
                                      },
                                      "goodsName": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider goodsName; preserve identifier and timestamp strings."
                                      },
                                      "goodsNameCn": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider goodsNameCn; preserve identifier and timestamp strings."
                                      },
                                      "goodsNameEn": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider goodsNameEn; preserve identifier and timestamp strings."
                                      },
                                      "brand": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider brand; preserve identifier and timestamp strings."
                                      },
                                      "sku": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider sku; preserve identifier and timestamp strings."
                                      },
                                      "onSaleTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider onSaleTime; preserve identifier and timestamp strings."
                                      },
                                      "mallOpenTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider mallOpenTime; preserve identifier and timestamp strings."
                                      },
                                      "createTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider createTime; preserve identifier and timestamp strings."
                                      },
                                      "updateTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider updateTime; preserve identifier and timestamp strings."
                                      },
                                      "sold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider sold; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "quantity": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider quantity; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "mallSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider mallSold; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "sales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider sales; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "minPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider minPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "maxPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider maxPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "supplyPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider supplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "minSupplyPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider minSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "medianSupplyPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider medianSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "maxSupplyPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider maxSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "goodsScore": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider goodsScore; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "reviewNum": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider reviewNum; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "hostingMode": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider hostingMode; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "status": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider status; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "similarNum": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider similarNum; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "catIds": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "description": "Associated category identifiers.",
                                        "items": {}
                                      },
                                      "catItems": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "description": "Category paths: catId, catName, catLevel, parentCatId and isLeaf.",
                                        "items": {}
                                      },
                                      "daySold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sold metric; sales revenue uses site currency."
                                      },
                                      "daySoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sold."
                                      },
                                      "daySales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sales metric; sales revenue uses site currency."
                                      },
                                      "daySalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sales."
                                      },
                                      "weekSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sold metric; sales revenue uses site currency."
                                      },
                                      "weekSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sold."
                                      },
                                      "weekSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sales metric; sales revenue uses site currency."
                                      },
                                      "weekSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sales."
                                      },
                                      "monthSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sold metric; sales revenue uses site currency."
                                      },
                                      "monthSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sold."
                                      },
                                      "monthSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sales metric; sales revenue uses site currency."
                                      },
                                      "monthSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sales."
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Provider match count, possibly capped at 10000 for searches."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "regionId": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Region used for the query."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Current page."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "size": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Items per page."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "columns": [],
                    "items": [],
                    "total": 0,
                    "regionId": 211,
                    "page": 1,
                    "size": 3
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "geekbi-temu-goods-search",
        "x-nexscope-mcp-tool-name": "nexscope_geekbi_temu_goods_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/geekbi-temu-keyword-search/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Nexscope Temu Keyword Research",
        "description": "Execute the selected keyword research operation and preserve provider business fields and extensions.",
        "operationId": "runGeekbiTemuKeywordSearch",
        "externalDocs": {
          "description": "Nexscope Temu Keyword Research documentation",
          "url": "https://www.nexscope.ai/api-docs/geekbi-temu-keyword-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "regionId": {
                    "type": "integer",
                    "description": "Temu region from sites[].regionId; never siteId.",
                    "minimum": 1,
                    "default": 211
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number.",
                    "minimum": 1,
                    "default": 1
                  },
                  "size": {
                    "type": "integer",
                    "description": "Items per page; page times size must not exceed 10000.",
                    "minimum": 1,
                    "maximum": 200,
                    "default": 20
                  },
                  "keyword": {
                    "type": "string",
                    "description": "User keyword; preserve the supplied language.",
                    "maxLength": 300
                  },
                  "sort": {
                    "type": "string",
                    "description": "Confirmed provider sort field; omit when unnecessary.",
                    "maxLength": 100
                  },
                  "order": {
                    "type": "string",
                    "description": "Sort direction, case-insensitive.",
                    "pattern": "^([aA][sS][cC]|[dD][eE][sS][cC])$"
                  },
                  "dsrMin": {
                    "type": "number",
                    "description": "Lower bound for dsr; minimum must not exceed maximum."
                  },
                  "dsrMax": {
                    "type": "number",
                    "description": "Upper bound for dsr; minimum must not exceed maximum."
                  },
                  "totalSoldMin": {
                    "type": "integer",
                    "description": "Lower bound for totalSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "totalSoldMax": {
                    "type": "integer",
                    "description": "Upper bound for totalSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "itemCountMin": {
                    "type": "integer",
                    "description": "Lower bound for itemCount; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "itemCountMax": {
                    "type": "integer",
                    "description": "Upper bound for itemCount; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallCountMin": {
                    "type": "integer",
                    "description": "Lower bound for mallCount; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallCountMax": {
                    "type": "integer",
                    "description": "Upper bound for mallCount; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "avgPriceMin": {
                    "type": "number",
                    "description": "Lower bound for avgPrice; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "avgPriceMax": {
                    "type": "number",
                    "description": "Upper bound for avgPrice; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "totalSalesMin": {
                    "type": "number",
                    "description": "Lower bound for totalSales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "totalSalesMax": {
                    "type": "number",
                    "description": "Upper bound for totalSales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "catIds": {
                    "type": "array",
                    "description": "Category identifiers obtained from category lookup.",
                    "items": {
                      "type": "integer",
                      "minimum": 0
                    }
                  },
                  "firstOnSaleTimeMin": {
                    "type": "string",
                    "description": "Earliest firstOnSaleTime in ISO-8601 date-time; minimum must not exceed maximum.",
                    "maxLength": 40,
                    "format": "date-time"
                  },
                  "firstOnSaleTimeMax": {
                    "type": "string",
                    "description": "Latest firstOnSaleTime in ISO-8601 date-time; minimum must not exceed maximum.",
                    "maxLength": 40,
                    "format": "date-time"
                  }
                },
                "required": []
              },
              "example": {
                "regionId": 211,
                "page": 1,
                "size": 3,
                "keyword": "dress"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "columns": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Render column definitions; business records are separate.",
                                  "items": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: title."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: type."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceTool."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceType."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "items": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Returned records, including valid empty results; preserve duplicate records and unknown fields.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider id; preserve identifier and timestamp strings."
                                      },
                                      "keyword": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider keyword; preserve identifier and timestamp strings."
                                      },
                                      "cnKeyword": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider cnKeyword; preserve identifier and timestamp strings."
                                      },
                                      "thumbnail": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider thumbnail; preserve identifier and timestamp strings."
                                      },
                                      "firstOnSaleTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider firstOnSaleTime; preserve identifier and timestamp strings."
                                      },
                                      "createTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider createTime; preserve identifier and timestamp strings."
                                      },
                                      "updateTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider updateTime; preserve identifier and timestamp strings."
                                      },
                                      "regionId": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider regionId; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "dsr": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider dsr; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "totalSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider totalSold; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "totalSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider totalSales; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "avgPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider avgPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "itemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider itemCount; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "mallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider mallCount; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "semiManagedItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider semiManagedItemCount; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "semiManagedMallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider semiManagedMallCount; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "catIds": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "description": "Associated category identifiers.",
                                        "items": {}
                                      },
                                      "catItems": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "description": "Category paths: catId, catName, catLevel, parentCatId and isLeaf.",
                                        "items": {}
                                      },
                                      "daySold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sold metric; sales revenue uses site currency."
                                      },
                                      "daySoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sold."
                                      },
                                      "daySales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sales metric; sales revenue uses site currency."
                                      },
                                      "daySalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sales."
                                      },
                                      "dayItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day ItemCount metric; sales revenue uses site currency."
                                      },
                                      "dayItemCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day ItemCount."
                                      },
                                      "dayMallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day MallCount metric; sales revenue uses site currency."
                                      },
                                      "dayMallCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day MallCount."
                                      },
                                      "weekSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sold metric; sales revenue uses site currency."
                                      },
                                      "weekSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sold."
                                      },
                                      "weekSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sales metric; sales revenue uses site currency."
                                      },
                                      "weekSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sales."
                                      },
                                      "weekItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week ItemCount metric; sales revenue uses site currency."
                                      },
                                      "weekItemCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week ItemCount."
                                      },
                                      "weekMallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week MallCount metric; sales revenue uses site currency."
                                      },
                                      "weekMallCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week MallCount."
                                      },
                                      "monthSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sold metric; sales revenue uses site currency."
                                      },
                                      "monthSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sold."
                                      },
                                      "monthSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sales metric; sales revenue uses site currency."
                                      },
                                      "monthSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sales."
                                      },
                                      "monthItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month ItemCount metric; sales revenue uses site currency."
                                      },
                                      "monthItemCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month ItemCount."
                                      },
                                      "monthMallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month MallCount metric; sales revenue uses site currency."
                                      },
                                      "monthMallCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month MallCount."
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Provider match count, possibly capped at 10000 for searches."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "regionId": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Region used for the query."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Current page."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "size": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Items per page."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "columns": [],
                    "items": [],
                    "total": 0,
                    "regionId": 211,
                    "page": 1,
                    "size": 3
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "geekbi-temu-keyword-search",
        "x-nexscope-mcp-tool-name": "nexscope_geekbi_temu_keyword_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/geekbi-temu-category-search/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Nexscope Temu Category Research",
        "description": "Execute the selected category research operation and preserve provider business fields and extensions.",
        "operationId": "runGeekbiTemuCategorySearch",
        "externalDocs": {
          "description": "Nexscope Temu Category Research documentation",
          "url": "https://www.nexscope.ai/api-docs/geekbi-temu-category-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "regionId": {
                    "type": "integer",
                    "description": "Temu region from sites[].regionId; never siteId.",
                    "minimum": 1,
                    "default": 211
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number.",
                    "minimum": 1,
                    "default": 1
                  },
                  "size": {
                    "type": "integer",
                    "description": "Items per page; page times size must not exceed 10000.",
                    "minimum": 1,
                    "maximum": 200,
                    "default": 20
                  },
                  "keyword": {
                    "type": "string",
                    "description": "User keyword; preserve the supplied language.",
                    "maxLength": 300
                  },
                  "sort": {
                    "type": "string",
                    "description": "Confirmed provider sort field; omit when unnecessary.",
                    "maxLength": 100
                  },
                  "order": {
                    "type": "string",
                    "description": "Sort direction, case-insensitive.",
                    "pattern": "^([aA][sS][cC]|[dD][eE][sS][cC])$"
                  },
                  "dsrMin": {
                    "type": "number",
                    "description": "Lower bound for dsr; minimum must not exceed maximum."
                  },
                  "dsrMax": {
                    "type": "number",
                    "description": "Upper bound for dsr; minimum must not exceed maximum."
                  },
                  "totalSoldMin": {
                    "type": "integer",
                    "description": "Lower bound for totalSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "totalSoldMax": {
                    "type": "integer",
                    "description": "Upper bound for totalSold; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "itemCountMin": {
                    "type": "integer",
                    "description": "Lower bound for itemCount; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "itemCountMax": {
                    "type": "integer",
                    "description": "Upper bound for itemCount; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallCountMin": {
                    "type": "integer",
                    "description": "Lower bound for mallCount; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "mallCountMax": {
                    "type": "integer",
                    "description": "Upper bound for mallCount; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "avgPriceMin": {
                    "type": "number",
                    "description": "Lower bound for avgPrice; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "avgPriceMax": {
                    "type": "number",
                    "description": "Upper bound for avgPrice; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "totalSalesMin": {
                    "type": "number",
                    "description": "Lower bound for totalSales; minimum must not exceed maximum.",
                    "minimum": 0
                  },
                  "totalSalesMax": {
                    "type": "number",
                    "description": "Upper bound for totalSales; minimum must not exceed maximum.",
                    "minimum": 0
                  }
                },
                "required": []
              },
              "example": {
                "regionId": 211,
                "page": 1,
                "size": 3,
                "keyword": "pets"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "columns": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Render column definitions; business records are separate.",
                                  "items": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: title."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: type."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceTool."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata: sourceType."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "items": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Returned records, including valid empty results; preserve duplicate records and unknown fields.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "catName": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider catName; preserve identifier and timestamp strings."
                                      },
                                      "thumbnail": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider thumbnail; preserve identifier and timestamp strings."
                                      },
                                      "createTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider createTime; preserve identifier and timestamp strings."
                                      },
                                      "updateTime": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider updateTime; preserve identifier and timestamp strings."
                                      },
                                      "regionId": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider regionId; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "dsr": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider dsr; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "totalSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider totalSold; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "totalSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider totalSales; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "avgPrice": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider avgPrice; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "itemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider itemCount; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "mallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider mallCount; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "semiManagedItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider semiManagedItemCount; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "semiManagedMallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider semiManagedMallCount; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "catId": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider catId; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "optId": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider optId; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "catLevel": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider catLevel; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "parentCatId": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider parentCatId; monetary values use the selected site's currency unless identified as supply prices."
                                      },
                                      "isLeaf": {
                                        "type": [
                                          "boolean",
                                          "null"
                                        ],
                                        "description": "Whether this category is a leaf."
                                      },
                                      "parentCatItems": {
                                        "type": [
                                          "array",
                                          "null"
                                        ],
                                        "description": "Full parent category path.",
                                        "items": {}
                                      },
                                      "daySold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sold metric; sales revenue uses site currency."
                                      },
                                      "daySoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sold."
                                      },
                                      "daySales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day Sales metric; sales revenue uses site currency."
                                      },
                                      "daySalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day Sales."
                                      },
                                      "dayItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day ItemCount metric; sales revenue uses site currency."
                                      },
                                      "dayItemCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day ItemCount."
                                      },
                                      "dayMallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider day MallCount metric; sales revenue uses site currency."
                                      },
                                      "dayMallCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for day MallCount."
                                      },
                                      "weekSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sold metric; sales revenue uses site currency."
                                      },
                                      "weekSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sold."
                                      },
                                      "weekSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week Sales metric; sales revenue uses site currency."
                                      },
                                      "weekSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week Sales."
                                      },
                                      "weekItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week ItemCount metric; sales revenue uses site currency."
                                      },
                                      "weekItemCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week ItemCount."
                                      },
                                      "weekMallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider week MallCount metric; sales revenue uses site currency."
                                      },
                                      "weekMallCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for week MallCount."
                                      },
                                      "monthSold": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sold metric; sales revenue uses site currency."
                                      },
                                      "monthSoldRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sold."
                                      },
                                      "monthSales": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month Sales metric; sales revenue uses site currency."
                                      },
                                      "monthSalesRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month Sales."
                                      },
                                      "monthItemCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month ItemCount metric; sales revenue uses site currency."
                                      },
                                      "monthItemCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month ItemCount."
                                      },
                                      "monthMallCount": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider month MallCount metric; sales revenue uses site currency."
                                      },
                                      "monthMallCountRate": {
                                        "type": [
                                          "number",
                                          "null"
                                        ],
                                        "description": "Provider growth rate for month MallCount."
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Provider match count, possibly capped at 10000 for searches."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "regionId": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Region used for the query."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Current page."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "size": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Items per page."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "columns": [],
                    "items": [],
                    "total": 0,
                    "regionId": 211,
                    "page": 1,
                    "size": 3
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "geekbi-temu-category-search",
        "x-nexscope-mcp-tool-name": "nexscope_geekbi_temu_category_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/geekbi-temu-category-list/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Nexscope Temu Category List",
        "description": "Return provider category records without inventing search pagination fields.",
        "operationId": "runGeekbiTemuCategoryList",
        "externalDocs": {
          "description": "Nexscope Temu Category List documentation",
          "url": "https://www.nexscope.ai/api-docs/geekbi-temu-category-list"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "parentCatId": {
                    "minimum": 0,
                    "type": "integer"
                  }
                },
                "additionalProperties": false,
                "type": "object"
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Number of returned records."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Provider render column metadata.",
                                  "items": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "categories": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Category tree nodes.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "catId": {
                                        "type": [
                                          "integer",
                                          "null"
                                        ],
                                        "description": "Provider category identifier."
                                      },
                                      "catLevel": {
                                        "type": [
                                          "integer",
                                          "null"
                                        ],
                                        "description": "Provider category identifier."
                                      },
                                      "parentCatId": {
                                        "type": [
                                          "integer",
                                          "null"
                                        ],
                                        "description": "Provider category identifier."
                                      },
                                      "catName": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider catName."
                                      },
                                      "isLeaf": {
                                        "type": [
                                          "boolean",
                                          "null"
                                        ],
                                        "description": "Whether this category is a leaf."
                                      },
                                      "extraFields": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "description": "Optional provider extension fields."
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "parentCatId": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Supplied parent category ID, if present."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "columns": [],
                    "total": 0,
                    "categories": []
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "geekbi-temu-category-list",
        "x-nexscope-mcp-tool-name": "nexscope_geekbi_temu_category_list",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/geekbi-temu-site-list/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Nexscope Temu Site List",
        "description": "Return provider site records without inventing search pagination fields.",
        "operationId": "runGeekbiTemuSiteList",
        "externalDocs": {
          "description": "Nexscope Temu Site List documentation",
          "url": "https://www.nexscope.ai/api-docs/geekbi-temu-site-list"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "properties": {},
                "additionalProperties": false,
                "type": "object"
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": [
                                    "integer",
                                    "null"
                                  ],
                                  "description": "Number of returned records."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Provider render column metadata.",
                                  "items": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "Provider render/source metadata."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sites": {
                              "anyOf": [
                                {
                                  "type": [
                                    "array",
                                    "null"
                                  ],
                                  "description": "Supported Temu sites.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "regionId": {
                                        "type": [
                                          "integer",
                                          "null"
                                        ],
                                        "description": "Positive Temu region ID accepted by other endpoints."
                                      },
                                      "siteId": {
                                        "type": [
                                          "integer",
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider internal ID; do not use it as a regionId filter."
                                      },
                                      "name": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Temu site name."
                                      },
                                      "cnName": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider cnName."
                                      },
                                      "lang": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider lang."
                                      },
                                      "currency": {
                                        "type": [
                                          "string",
                                          "null"
                                        ],
                                        "description": "Provider currency."
                                      },
                                      "extraFields": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "description": "Optional provider extension fields."
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "additionalProperties": true,
                          "required": []
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "columns": [],
                    "sites": [],
                    "total": 0
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "geekbi-temu-site-list",
        "x-nexscope-mcp-tool-name": "nexscope_geekbi_temu_site_list",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/1688-product-billboard/run": {
      "post": {
        "tags": [
          "1688 Sourcing"
        ],
        "summary": "1688 Product Billboard",
        "description": "Query 1688 product bestseller billboard data for sourcing discovery and wholesale product research. Trigger when the user mentions 1688 product rankings, 1688 bestseller lists, wholesale hot products, domestic sourcing rankings, dropshipping product selection, 1688 trending products, bulk purchase popular items, supplier product rankings, 1688 billboard, 1688 bestsellers, sourcing rankings, wholesale hot products, trending product rankings, supplier rankings, 1688 trends. Even if the user does not explicitly mention \"1688 billboard\", if their need involves discovering hot-selling wholesale products or sourcing opportunities on the 1688 platform, this skill should also be triggered.",
        "operationId": "run1688ProductBillboard",
        "externalDocs": {
          "description": "1688 Product Billboard documentation",
          "url": "https://www.nexscope.ai/api-docs/1688-product-billboard"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.1688-product-billboard.",
                "properties": {
                  "keyWord": {
                    "type": "string",
                    "description": "Product search keyword (must be written in Simplified Chinese; translate it before calling this API). Maximum 50 characters",
                    "example": "iPhone 15"
                  },
                  "date": {
                    "type": "string",
                    "description": "Query time. Weekly chart: pass the Sunday date of that week, e.g. 2025-06-15 (up to 90 days); Monthly chart: pass the first day of the month, e.g. 2025-06-01 (up to one year)",
                    "example": "2026-07-01"
                  },
                  "pageType": {
                    "type": "integer",
                    "description": "Billboard type: 2 = weekly, 3 = monthly. Default 3",
                    "example": 3
                  },
                  "pageIndex": {
                    "type": "integer",
                    "description": "Page number (starting from 1), default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Number of results per page (10-100), default 20",
                    "example": 10
                  },
                  "sortField": {
                    "type": "string",
                    "description": "Sort field, default orderCount. Options: orderCount (order count), saleCount (units sold), saleVolume (estimated sales amount), offerCreateTime (listing time), price (wholesale price), consignPrice (dropship price)"
                  },
                  "sortType": {
                    "type": "string",
                    "description": "Sort order: desc (descending), asc (ascending), default desc"
                  },
                  "searchType": {
                    "type": "integer",
                    "description": "Product keyword search type: 1 = fuzzy match, 3 = exact match. Default 1",
                    "example": 1
                  },
                  "offerType": {
                    "type": "integer",
                    "description": "Product tag: 0 = no limit, 2 = new product, 3 = 1688 Select, 4 = cross-border, 5 = customization supported, 6 = store highlight. Default 0",
                    "example": 1
                  },
                  "companyType": {
                    "type": "integer",
                    "description": "Company type: 0 = no limit, 1 = store, 2 = factory",
                    "example": 1
                  },
                  "shiLiType": {
                    "type": "string",
                    "description": "Seller membership type (multi-select), comma-separated. Options: superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass member only)"
                  },
                  "beginTpYear": {
                    "type": "integer",
                    "description": "Start TrustPass years",
                    "example": 1
                  },
                  "endTpYear": {
                    "type": "integer",
                    "description": "End TrustPass years",
                    "example": 1
                  },
                  "beginPrice": {
                    "type": "number",
                    "description": "Wholesale price (start)",
                    "example": 1
                  },
                  "endPrice": {
                    "type": "number",
                    "description": "Wholesale price (end)",
                    "example": 1
                  },
                  "beginConsignPrice": {
                    "type": "number",
                    "description": "Dropship price (start)",
                    "example": 1
                  },
                  "endConsignPrice": {
                    "type": "number",
                    "description": "Dropship price (end)",
                    "example": 1
                  },
                  "beginOrderCount": {
                    "type": "integer",
                    "description": "Order count (start)",
                    "example": 1
                  },
                  "endOrderCount": {
                    "type": "integer",
                    "description": "Order count (end)",
                    "example": 1
                  },
                  "beginSaleCount": {
                    "type": "integer",
                    "description": "Units sold (start)",
                    "example": 1
                  },
                  "endSaleCount": {
                    "type": "integer",
                    "description": "Units sold (end)",
                    "example": 1
                  },
                  "beginSaleVolume": {
                    "type": "number",
                    "description": "Sales amount (start)",
                    "example": 1
                  },
                  "endSaleVolume": {
                    "type": "number",
                    "description": "Sales amount (end)",
                    "example": 1
                  },
                  "beginStartQuantity": {
                    "type": "integer",
                    "description": "Minimum order quantity (start)",
                    "example": 1
                  },
                  "endStartQuantity": {
                    "type": "integer",
                    "description": "Minimum order quantity (end)",
                    "example": 1
                  },
                  "beginOfferCreateTime": {
                    "type": "string",
                    "description": "Listing time (start), format: YYYY-MM-DD"
                  },
                  "endOfferCreateTime": {
                    "type": "string",
                    "description": "Listing time (end), format: YYYY-MM-DD"
                  },
                  "sendTime": {
                    "type": "string",
                    "description": "Delivery time (multi-select), comma-separated. Options: 24 (24 hours), 48 (48 hours), 72 (72 hours)"
                  },
                  "proxyRights": {
                    "type": "string",
                    "description": "Dropship rights (multi-select), comma-separated. Options: 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later)"
                  },
                  "shopService": {
                    "type": "string",
                    "description": "Seller services (multi-select), comma-separated. Options: 4057409 (Safe Buy), 888777 (Deep Verification Report)"
                  },
                  "buyerProtections": {
                    "type": "string",
                    "description": "Buyer protections, comma-separated: free shipping, 7-day free return, or shipping insurance"
                  },
                  "faceToFaceSupport": {
                    "type": "string",
                    "description": "Waybill support (multi-select), comma-separated. Options: 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)"
                  },
                  "productIds": {
                    "type": "string",
                    "description": "Product IDs, separated by Chinese comma for multiple, max 20"
                  },
                  "goodsUrl": {
                    "type": "string",
                    "description": "Product link URL",
                    "example": "https://example.com/image.jpg"
                  }
                },
                "example": {
                  "pageIndex": 1,
                  "searchType": 1,
                  "pageType": 3,
                  "pageSize": 10,
                  "date": "2026-07-01",
                  "keyWord": "iPhone 15"
                },
                "additionalProperties": true
              },
              "example": {
                "pageIndex": 1,
                "searchType": 1,
                "pageType": 3,
                "pageSize": 10,
                "date": "2026-07-01",
                "keyWord": "iPhone 15"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see Product Object below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "offerId": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "example-id"
                                      },
                                      "asin": {
                                        "type": "string",
                                        "description": "Product number",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Wholesale price",
                                        "example": 1
                                      },
                                      "consignPrice": {
                                        "type": "number",
                                        "description": "Dropship price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "unit": {
                                        "type": "string",
                                        "description": "Unit",
                                        "example": null
                                      },
                                      "quantityBegin": {
                                        "type": "integer",
                                        "description": "Minimum order quantity",
                                        "example": 1
                                      },
                                      "quantityPrices": {
                                        "type": "string",
                                        "description": "Price range",
                                        "example": null
                                      },
                                      "salesOrderCount": {
                                        "type": "integer",
                                        "description": "Order count (returns corresponding value based on statistical period)",
                                        "example": 1
                                      },
                                      "salesQuantity": {
                                        "type": "integer",
                                        "description": "Units sold (returns corresponding value based on statistical period)",
                                        "example": 1
                                      },
                                      "estimatedSalesAmount": {
                                        "type": "integer",
                                        "description": "Estimated sales amount (returns corresponding value based on statistical period)",
                                        "example": 1
                                      },
                                      "dataType": {
                                        "type": "string",
                                        "description": "Data type: weeklyData = weekly data, monthlyData = monthly data",
                                        "example": null
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Product listing time, format yyyy-MM-dd HH:mm:ss",
                                        "example": "2026-01-01"
                                      },
                                      "deliveryTime": {
                                        "type": "string",
                                        "description": "Delivery time",
                                        "example": null
                                      },
                                      "levelName": {
                                        "type": "string",
                                        "description": "Category hierarchy name",
                                        "example": null
                                      },
                                      "company": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "shopId": {
                                        "type": "string",
                                        "description": "Store ID",
                                        "example": "example-id"
                                      },
                                      "shopUrl": {
                                        "type": "string",
                                        "description": "Store link URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Product link URL",
                                        "example": "https://detail.1688.com/offer/1040473674152.html"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source platform (1688)",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "columns": [],
                    "products": [
                      {
                        "offerId": "example-id",
                        "asin": "B072MQ5BRX",
                        "price": 1,
                        "consignPrice": 1,
                        "quantityBegin": 1,
                        "salesOrderCount": 1,
                        "salesQuantity": 1,
                        "estimatedSalesAmount": 1,
                        "availableDate": "2026-01-01",
                        "shopId": "example-id",
                        "shopUrl": "https://example.com/image.jpg",
                        "asinUrl": "https://detail.1688.com/offer/1040473674152.html",
                        "imageUrl": "https://example.com/image.jpg"
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "1688-product-billboard",
        "x-nexscope-mcp-tool-name": "nexscope_1688_product_billboard",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/1688-product-search/run": {
      "post": {
        "tags": [
          "1688 Sourcing"
        ],
        "summary": "1688 Product Search",
        "description": "Search and analyze products on the Chinese 1688 wholesale platform (Alibaba domestic B2B market) for sourcing, supplier discovery, and product selection. Trigger when the user mentions 1688 product search, finding suppliers on 1688, wholesale product queries, factory sourcing, dropshipping supplier search, 1688 keyword product selection, wholesale price comparison, filtering by sales volume, any product research on the 1688 platform, 1688 search, 1688 product selection, find suppliers, factory lookup, wholesale pricing, supplier search, domestic sourcing, 1688 products. Even if the user does not explicitly say \"1688\", if their need involves searching for wholesale products, finding domestic suppliers, or sourcing from the domestic Chinese market, this skill should also be triggered.",
        "operationId": "run1688ProductSearch",
        "externalDocs": {
          "description": "1688 Product Search documentation",
          "url": "https://www.nexscope.ai/api-docs/1688-product-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.1688-product-search.",
                "properties": {
                  "keyWord": {
                    "type": "string",
                    "description": "Search keyword (must be written in Simplified Chinese; maximum 50 characters)",
                    "example": "iPhone 15"
                  },
                  "goodsUrl": {
                    "type": "string",
                    "description": "Product link URL (mutually exclusive with keyWord)",
                    "example": "https://example.com/image.jpg"
                  },
                  "productIds": {
                    "type": "string",
                    "description": "Product IDs, comma-separated, max 20"
                  },
                  "cycle": {
                    "type": "string",
                    "description": "Statistical period: 7 (last 7 days) or 30 (last 30 days)"
                  },
                  "searchType": {
                    "type": "integer",
                    "description": "Search type: 1 = fuzzy match, 3 = exact match",
                    "example": 1
                  },
                  "sortField": {
                    "type": "string",
                    "description": "Sort field: orderCount7d, saleCount7d, saleVolume7d, orderCount30d, saleCount30d, saleVolume30d, offerCreateTime, price, consignPrice"
                  },
                  "sortType": {
                    "type": "string",
                    "description": "Sort order: desc (descending), asc (ascending)"
                  },
                  "pageIndex": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page (10-100)",
                    "example": 10
                  },
                  "beginPrice": {
                    "type": "number",
                    "description": "Wholesale price (start)",
                    "example": 1
                  },
                  "endPrice": {
                    "type": "number",
                    "description": "Wholesale price (end)",
                    "example": 1
                  },
                  "beginConsignPrice": {
                    "type": "number",
                    "description": "Dropship price (start)",
                    "example": 1
                  },
                  "endConsignPrice": {
                    "type": "number",
                    "description": "Dropship price (end)",
                    "example": 1
                  },
                  "beginOrderCount": {
                    "type": "integer",
                    "description": "Order count (start)",
                    "example": 1
                  },
                  "endOrderCount": {
                    "type": "integer",
                    "description": "Order count (end)",
                    "example": 1
                  },
                  "beginSaleCount": {
                    "type": "integer",
                    "description": "Units sold (start)",
                    "example": 1
                  },
                  "endSaleCount": {
                    "type": "integer",
                    "description": "Units sold (end)",
                    "example": 1
                  },
                  "beginSaleVolume": {
                    "type": "number",
                    "description": "Sales amount (start)",
                    "example": 1
                  },
                  "endSaleVolume": {
                    "type": "number",
                    "description": "Sales amount (end)",
                    "example": 1
                  },
                  "beginStartQuantity": {
                    "type": "integer",
                    "description": "Minimum purchase quantity (start)",
                    "example": 1
                  },
                  "endStartQuantity": {
                    "type": "integer",
                    "description": "Minimum purchase quantity (end)",
                    "example": 1
                  },
                  "beginTpYear": {
                    "type": "integer",
                    "description": "TrustPass years (start)",
                    "example": 1
                  },
                  "endTpYear": {
                    "type": "integer",
                    "description": "TrustPass years (end)",
                    "example": 1
                  },
                  "beginOfferCreateTime": {
                    "type": "string",
                    "description": "Listing time start (format: YYYY-MM-DD)"
                  },
                  "endOfferCreateTime": {
                    "type": "string",
                    "description": "Listing time end (format: YYYY-MM-DD)"
                  },
                  "companyType": {
                    "type": "integer",
                    "description": "Company type: 0 = no limit, 1 = store, 2 = factory",
                    "example": 1
                  },
                  "offerType": {
                    "type": "integer",
                    "description": "Product tag: 0 = no limit, 2 = new product, 3 = 1688 Select, 4 = cross-border, 5 = customization supported, 6 = store highlight",
                    "example": 1
                  },
                  "shiLiType": {
                    "type": "string",
                    "description": "Seller type (multi-select, comma-separated): superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass)"
                  },
                  "sendTime": {
                    "type": "string",
                    "description": "Delivery time (multi-select, comma-separated): 24, 48, 72"
                  },
                  "faceToFaceSupport": {
                    "type": "string",
                    "description": "Waybill support (multi-select, comma-separated): 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)"
                  },
                  "proxyRights": {
                    "type": "string",
                    "description": "Dropship rights (multi-select, comma-separated): 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later)"
                  },
                  "shopService": {
                    "type": "string",
                    "description": "Seller services (multi-select, comma-separated): 4057409 (Safe Buy), 888777 (Deep Verification Report)"
                  },
                  "buyerProtections": {
                    "type": "string",
                    "description": "Buyer protections, comma-separated: free shipping, 7-day free return, or shipping insurance"
                  }
                },
                "example": {
                  "pageIndex": 1,
                  "searchType": 1,
                  "keyWord": "iPhone 15",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "pageIndex": 1,
                "searchType": 1,
                "keyWord": "iPhone 15",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "offerId": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "example-id"
                                      },
                                      "asin": {
                                        "type": "string",
                                        "description": "Product number",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Product link URL",
                                        "example": "https://detail.1688.com/offer/1040473674152.html"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Wholesale price",
                                        "example": 1
                                      },
                                      "consignPrice": {
                                        "type": "number",
                                        "description": "Dropship price",
                                        "example": 1
                                      },
                                      "quantityPrices": {
                                        "type": "string",
                                        "description": "Price range",
                                        "example": null
                                      },
                                      "quantityBegin": {
                                        "type": "integer",
                                        "description": "Minimum order quantity",
                                        "example": 1
                                      },
                                      "unit": {
                                        "type": "string",
                                        "description": "Unit",
                                        "example": null
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "salesOrderCount": {
                                        "type": "integer",
                                        "description": "Order count (by statistical period)",
                                        "example": 1
                                      },
                                      "salesQuantity": {
                                        "type": "integer",
                                        "description": "Units sold (by statistical period)",
                                        "example": 1
                                      },
                                      "estimatedSalesAmount": {
                                        "type": "integer",
                                        "description": "Estimated sales amount (by statistical period)",
                                        "example": 1
                                      },
                                      "deliveryTime": {
                                        "type": "string",
                                        "description": "Delivery time",
                                        "example": null
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Product listing time",
                                        "example": "2026-01-01"
                                      },
                                      "levelName": {
                                        "type": "string",
                                        "description": "Category hierarchy name",
                                        "example": null
                                      },
                                      "company": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "shopId": {
                                        "type": "string",
                                        "description": "Store ID",
                                        "example": "example-id"
                                      },
                                      "shopUrl": {
                                        "type": "string",
                                        "description": "Store link URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "dataType": {
                                        "type": "string",
                                        "description": "Data type: weeklyData (weekly data), monthlyData (monthly data)",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source platform (1688)",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "columns": [],
                    "products": [
                      {
                        "offerId": "example-id",
                        "asin": "B072MQ5BRX",
                        "asinUrl": "https://detail.1688.com/offer/1040473674152.html",
                        "imageUrl": "https://example.com/image.jpg",
                        "price": 1,
                        "consignPrice": 1,
                        "quantityBegin": 1,
                        "salesOrderCount": 1,
                        "salesQuantity": 1,
                        "estimatedSalesAmount": 1,
                        "availableDate": "2026-01-01",
                        "shopId": "example-id",
                        "shopUrl": "https://example.com/image.jpg"
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "1688-product-search",
        "x-nexscope-mcp-tool-name": "nexscope_1688_product_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/1688-search-by-image/run": {
      "post": {
        "tags": [
          "1688 Sourcing"
        ],
        "summary": "1688 Search By Image",
        "description": "Perform image-based product search on the 1688 platform. Use an image URL to find visually similar supplier products, returning title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller identity. Triggered when users mention 1688 image search, 1688 visual search, find supplier by image, reverse image search 1688, 1688 product sourcing by image, or Alibaba 1688 image search. Even if the user does not explicitly mention \"image search,\" this skill should be triggered whenever a user provides an image URL and wants to find matching or similar products on the 1688 wholesale platform.",
        "operationId": "run1688SearchByImage",
        "externalDocs": {
          "description": "1688 Search By Image documentation",
          "url": "https://www.nexscope.ai/api-docs/1688-search-by-image"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public HTTP/80 or HTTPS/443 URL, maximum 1,000 characters, without redirects. A sole direct source is checked for PNG/JPEG headers, at most 14.3 MiB, each dimension at most 20,000 and at most 40,000,000 pixels. This is not full pixel-integrity validation. imageId or ambiguous multiple sources preserve provider behavior and skip new preflight. Provide at least one image source.",
                    "example": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg"
                  },
                  "imageBase64": {
                    "type": "string",
                    "description": "Raw standard Base64 for PNG/JPEG; optional padding and outer whitespace allowed, embedded whitespace and data URI prefixes rejected for a sole direct source. Byte/header limits match imageUrl; at most 19,992,848 Base64 characters after outer whitespace trimming. Multiple-source inputs retain existing provider behavior.",
                    "example": null
                  },
                  "imageId": {
                    "type": "string",
                    "description": "1688 image ID. Image-search results also return this value; include it when page is greater than 1 to improve response time",
                    "example": null
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number starting from 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Number of products per page, maximum 50",
                    "example": 10
                  },
                  "priceStart": {
                    "type": "string",
                    "description": "Minimum price in CNY, for example 10",
                    "example": null
                  },
                  "priceEnd": {
                    "type": "string",
                    "description": "Maximum price in CNY, for example 100",
                    "example": null
                  },
                  "filter": {
                    "type": "string",
                    "description": "Comma-separated filter conditions. Use the supported filter values documented for this endpoint",
                    "example": null
                  },
                  "sort": {
                    "type": "string",
                    "description": "Sort condition as JSON in the form {field: direction}. Fields: price, rePurchaseRate, or monthSold. Directions: asc or desc",
                    "example": null
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Keyword used to search within the results",
                    "example": "phone case"
                  },
                  "productCollectionId": {
                    "type": "string",
                    "description": "Single product-collection ID. Use a supported collection ID documented for this endpoint",
                    "example": "example-id"
                  }
                },
                "required": [],
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "pageSize": 10,
                "imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "imageId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Uploaded image ID; send it with paginated requests to improve response time",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of products on this page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of pages",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type; fixed value \"1688\"",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendering style; fixed value \"productWorkbenches\"",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions used for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list; see the product fields below",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "offerId": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "example-id"
                                      },
                                      "asin": {
                                        "type": "string",
                                        "description": "Product identifier, same as offerId",
                                        "example": "example-id"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Wholesale price in CNY",
                                        "example": 1
                                      },
                                      "consignPrice": {
                                        "type": "number",
                                        "description": "Single-item dropshipping price in CNY",
                                        "example": 1
                                      },
                                      "salesQuantity": {
                                        "type": "integer",
                                        "description": "Monthly units sold",
                                        "example": 1
                                      },
                                      "estimatedSalesAmount": {
                                        "type": "number",
                                        "description": "Estimated sales revenue",
                                        "example": 1
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Product URL",
                                        "example": "https://detail.1688.com/offer/1040473674152.html"
                                      },
                                      "isOnePsale": {
                                        "type": "boolean",
                                        "description": "Whether single-item dropshipping is available",
                                        "example": null
                                      },
                                      "isJxhy": {
                                        "type": "boolean",
                                        "description": "Whether the product is a selected supply source",
                                        "example": null
                                      },
                                      "sellerIdentities": {
                                        "type": "string",
                                        "description": "Seller identities, such as Super Factory, Verified Supplier, or TrustPass member",
                                        "example": null
                                      },
                                      "offerIdentities": {
                                        "type": "string",
                                        "description": "Product badge, such as Strict Selection",
                                        "example": null
                                      },
                                      "repurchaseRate": {
                                        "type": "string",
                                        "description": "Repurchase rate",
                                        "example": null
                                      },
                                      "tradeScore": {
                                        "type": "string",
                                        "description": "Product transaction score",
                                        "example": null
                                      },
                                      "compositeServiceScore": {
                                        "type": "string",
                                        "description": "Composite service-experience score",
                                        "example": null
                                      },
                                      "sendGoodsAddressText": {
                                        "type": "string",
                                        "description": "Dispatch location",
                                        "example": null
                                      },
                                      "deliveryTime": {
                                        "type": "string",
                                        "description": "Dispatch time, such as 24 or 48 hours",
                                        "example": null
                                      },
                                      "quantityBegin": {
                                        "type": "integer",
                                        "description": "Minimum order quantity",
                                        "example": 1
                                      },
                                      "hasPromotion": {
                                        "type": "boolean",
                                        "description": "Whether a promotion is active",
                                        "example": null
                                      },
                                      "promotionType": {
                                        "type": "string",
                                        "description": "Promotion type",
                                        "example": null
                                      },
                                      "isPatentProduct": {
                                        "type": "boolean",
                                        "description": "Whether the product is patented",
                                        "example": null
                                      },
                                      "isSelect": {
                                        "type": "boolean",
                                        "description": "Cross-border Select collection indicator",
                                        "example": null
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency; fixed value \"¥\"",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source type; fixed value \"1688\"",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool; fixed value identifying 1688 image search",
                                        "example": null
                                      },
                                      "dataType": {
                                        "type": "string",
                                        "description": "Data type; fixed value \"monthlyData\"",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "imageId": "example-id",
                    "total": 1,
                    "totalPage": 1,
                    "columns": [],
                    "costToken": 1,
                    "products": [
                      {
                        "offerId": "example-id",
                        "asin": "example-id",
                        "imageUrl": "https://example.com/image.jpg",
                        "price": 1,
                        "consignPrice": 1,
                        "salesQuantity": 1,
                        "estimatedSalesAmount": 1,
                        "asinUrl": "https://detail.1688.com/offer/1040473674152.html",
                        "quantityBegin": 1
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "1688-search-by-image",
        "x-nexscope-mcp-tool-name": "nexscope_1688_search_by_image",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-ads-api-access/run": {
      "post": {
        "tags": [
          "Amazon Advertising"
        ],
        "summary": "Amazon Ads API Access",
        "description": "Starts Amazon Ads OAuth authorization or returns safe connection and profile metadata. Access and refresh tokens are never accepted or returned.",
        "operationId": "runAmazonAdsApiAccess",
        "externalDocs": {
          "description": "Amazon Ads API Access documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-ads-api-access"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Operation-specific inputs: authorize requires region and marketplaceId; profiles requires connectionId; connections requires no additional input. Connections are scoped to the API-key owner, and OAuth tokens are backend-owned.",
                "properties": {
                  "operation": {
                    "type": "string",
                    "description": "Operation: authorize, connections, or profiles.",
                    "example": "authorize"
                  },
                  "region": {
                    "type": "string",
                    "description": "Required when operation=authorize. Amazon Ads region: NA, EU, or FE.",
                    "example": "NA"
                  },
                  "marketplaceId": {
                    "type": "string",
                    "description": "Required when operation=authorize. Amazon marketplace identifier.",
                    "example": "ATVPDKIKX0DER"
                  },
                  "accountName": {
                    "type": "string",
                    "description": "Optional display name for the authorization request.",
                    "example": "US Ads account"
                  },
                  "connectionId": {
                    "type": "integer",
                    "description": "Required when operation=profiles. Owned Amazon Ads connection ID.",
                    "example": 123
                  }
                },
                "required": [
                  "operation",
                  "region",
                  "marketplaceId"
                ],
                "example": {
                  "operation": "authorize",
                  "marketplaceId": "ATVPDKIKX0DER",
                  "region": "NA",
                  "accountName": "US Ads account"
                },
                "additionalProperties": true
              },
              "example": {
                "operation": "authorize",
                "marketplaceId": "ATVPDKIKX0DER",
                "region": "NA",
                "accountName": "US Ads account"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "authorizationUrl": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "OAuth URL to open in a browser.",
                                  "example": "https://example.com/authorize"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "state": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Opaque OAuth state used only by the backend callback.",
                                  "example": "opaque-state"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "expiresAt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Authorization state expiry timestamp in milliseconds.",
                                  "example": 1760000000000
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "connections": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Safe owned Amazon Ads connection metadata.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "profiles": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Safe Amazon Ads profiles for the selected connection.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "profileId": {
                                        "type": "string",
                                        "description": "Amazon Ads profile ID.",
                                        "example": "123456789"
                                      },
                                      "countryCode": {
                                        "type": "string",
                                        "description": "Profile country code.",
                                        "example": "US"
                                      },
                                      "currencyCode": {
                                        "type": "string",
                                        "description": "Profile currency code.",
                                        "example": "USD"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "authorizationUrl": "https://example.com/authorize",
                    "state": "opaque-state",
                    "expiresAt": 1760000000000,
                    "connections": [],
                    "profiles": [
                      {
                        "profileId": "123456789",
                        "countryCode": "US",
                        "currencyCode": "USD"
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-ads-api-access",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_ads_api_access",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-ads-manager/run": {
      "post": {
        "tags": [
          "Amazon Advertising"
        ],
        "summary": "Amazon Ads Manager",
        "description": "Accepts only documented ads_manager.sb/sd/sp operation IDs. Provider methods and paths are derived server-side; mutations require preview followed by confirmation.",
        "operationId": "runAmazonAdsManager",
        "externalDocs": {
          "description": "Amazon Ads Manager documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-ads-manager"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "The API key owner must own connectionId. Raw provider method, path, content type, and workspace are not accepted.",
                "properties": {
                  "operationId": {
                    "type": "string",
                    "description": "Exact catalog operation ID, for example sp.list_campaigns.",
                    "example": "sp.list_campaigns"
                  },
                  "connectionId": {
                    "type": "integer",
                    "description": "Owned Amazon Ads connection ID.",
                    "example": 123
                  },
                  "payload": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Documented fields for the selected operation; required by create/update operations. SP POST /list filters such as campaignIdFilter and stateFilter belong in payload as objects with non-empty include arrays of strings.",
                    "example": {
                      "campaignIdFilter": {
                        "include": [
                          "123456789"
                        ]
                      },
                      "maxResults": 10
                    }
                  },
                  "queryString": {
                    "type": "string",
                    "description": "Optional operation-specific query string without a leading ?; do not use it for SP POST /list filters.",
                    "example": ""
                  },
                  "adType": {
                    "type": "string",
                    "description": "Required only by sb.create_ads.",
                    "example": "video"
                  },
                  "action": {
                    "type": "string",
                    "description": "preview (default) or confirm for mutations; ignored for reads.",
                    "example": "preview"
                  },
                  "confirmationToken": {
                    "type": "string",
                    "description": "Single-use token required when action is confirm.",
                    "example": "opaque-token"
                  }
                },
                "required": [
                  "operationId",
                  "connectionId"
                ],
                "example": {
                  "connectionId": 123,
                  "operationId": "sp.list_campaigns",
                  "payload": {
                    "campaignIdFilter": {
                      "include": [
                        "123456789"
                      ]
                    },
                    "maxResults": 10
                  }
                },
                "additionalProperties": true
              },
              "example": {
                "connectionId": 123,
                "operationId": "sp.list_campaigns",
                "payload": {
                  "campaignIdFilter": {
                    "include": [
                      "123456789"
                    ]
                  },
                  "maxResults": 10
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "description": "Safe Amazon Ads provider result.",
                                  "example": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "confirmationToken": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Single-use mutation confirmation token returned by preview.",
                                  "example": "opaque-token"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "expiresAt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Confirmation expiry timestamp when returned.",
                                  "example": 1760000000000
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {},
                    "confirmationToken": "opaque-token",
                    "expiresAt": 1760000000000
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-ads-manager",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_ads_manager",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-ads-reporting/run": {
      "post": {
        "tags": [
          "Amazon Advertising"
        ],
        "summary": "Amazon Ads Reporting",
        "description": "Uses the source get_report contract: omit reportId to create, supply reportId to poll, or supply a backend documentToken to download.",
        "operationId": "runAmazonAdsReporting",
        "externalDocs": {
          "description": "Amazon Ads Reporting documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-ads-reporting"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Create requires startDate/endDate plus configuration, or startDate/endDate plus reportTypeId/adProduct/groupBy/columns. Poll requires reportId. Download requires documentToken.",
                "properties": {
                  "connectionId": {
                    "type": "integer",
                    "description": "Owned Amazon Ads connection ID.",
                    "example": 123
                  },
                  "reportId": {
                    "type": "string",
                    "description": "Existing report ID; when present the API polls that report.",
                    "example": "report-id"
                  },
                  "reportTypeId": {
                    "type": "string",
                    "description": "Report type required by a new report unless configuration supplies it.",
                    "example": "spCampaigns"
                  },
                  "adProduct": {
                    "type": "string",
                    "description": "Ad product required by a new report unless configuration supplies it.",
                    "example": "SPONSORED_PRODUCTS"
                  },
                  "groupBy": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Report grouping fields.",
                    "example": [
                      "campaign"
                    ]
                  },
                  "columns": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Requested report columns.",
                    "example": [
                      "campaignId",
                      "impressions",
                      "clicks"
                    ]
                  },
                  "name": {
                    "type": "string",
                    "description": "Optional report name.",
                    "example": "Campaign report"
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Inclusive report start date for a new report.",
                    "example": "2026-07-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "Inclusive report end date for a new report.",
                    "example": "2026-07-31"
                  },
                  "timeUnit": {
                    "type": "string",
                    "description": "Optional report time unit.",
                    "example": "DAILY"
                  },
                  "format": {
                    "type": "string",
                    "description": "Optional report format.",
                    "example": "GZIP_JSON"
                  },
                  "filters": {
                    "type": "array",
                    "items": {},
                    "description": "Optional report filters.",
                    "example": []
                  },
                  "configuration": {
                    "type": "object",
                    "description": "Complete Amazon Ads reporting configuration; may replace reportTypeId/adProduct/groupBy/columns.",
                    "example": {},
                    "properties": {},
                    "additionalProperties": true
                  },
                  "documentToken": {
                    "type": "string",
                    "description": "Backend-issued token for downloading a completed report.",
                    "example": "opaque-document-token"
                  }
                },
                "required": [
                  "connectionId"
                ],
                "example": {
                  "startDate": "2026-07-01",
                  "reportTypeId": "spCampaigns",
                  "adProduct": "SPONSORED_PRODUCTS",
                  "connectionId": 123,
                  "groupBy": [
                    "campaign"
                  ],
                  "endDate": "2026-07-31",
                  "columns": [
                    "campaignId",
                    "impressions"
                  ]
                },
                "additionalProperties": true
              },
              "example": {
                "startDate": "2026-07-01",
                "reportTypeId": "spCampaigns",
                "adProduct": "SPONSORED_PRODUCTS",
                "connectionId": 123,
                "groupBy": [
                  "campaign"
                ],
                "endDate": "2026-07-31",
                "columns": [
                  "campaignId",
                  "impressions"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "status": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Report status.",
                                  "example": "PENDING"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "reportId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider report ID.",
                                  "example": "report-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "documentToken": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Safe opaque token used for download.",
                                  "example": "opaque-document-token"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "content": {
                              "anyOf": [
                                {
                                  "type": [
                                    "object",
                                    "array",
                                    "string"
                                  ],
                                  "description": "Downloaded report content when available.",
                                  "example": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "contentType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Downloaded report content type.",
                                  "example": "application/json"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "status": "PENDING",
                    "reportId": "report-id",
                    "documentToken": "opaque-document-token",
                    "content": {},
                    "contentType": "application/json"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-ads-reporting",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_ads_reporting",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-advertising/run": {
      "post": {
        "tags": [
          "Amazon Advertising"
        ],
        "summary": "Amazon Advertising",
        "description": "Accepts only documented ads_manager.sb/sd/sp operation IDs. Provider methods and paths are derived server-side; mutations require preview followed by confirmation.",
        "operationId": "runAmazonAdvertising",
        "externalDocs": {
          "description": "Amazon Advertising documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-advertising"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "The API key owner must own connectionId. Raw provider method, path, content type, and workspace are not accepted.",
                "properties": {
                  "operationId": {
                    "type": "string",
                    "description": "Exact catalog operation ID, for example ads_manager.sp.list_campaigns.",
                    "example": "ads_manager.sp.list_campaigns"
                  },
                  "connectionId": {
                    "type": "integer",
                    "description": "Owned Amazon Ads connection ID.",
                    "example": 123
                  },
                  "payload": {
                    "type": "object",
                    "description": "Documented fields for the selected operation; required by create/update operations. SP POST /list filters such as campaignIdFilter and stateFilter belong in payload as objects with non-empty include arrays of strings.",
                    "example": {
                      "campaignIdFilter": {
                        "include": [
                          "123456789"
                        ]
                      },
                      "maxResults": 10
                    },
                    "properties": {},
                    "additionalProperties": true
                  },
                  "queryString": {
                    "type": "string",
                    "description": "Optional operation-specific query string without a leading ?; do not use it for SP POST /list filters.",
                    "example": ""
                  },
                  "adType": {
                    "type": "string",
                    "description": "Required only by ads_manager.sb.create_ads.",
                    "example": "video"
                  },
                  "action": {
                    "type": "string",
                    "description": "preview (default) or confirm for mutations; ignored for reads.",
                    "example": "preview"
                  },
                  "confirmationToken": {
                    "type": "string",
                    "description": "Single-use token required when action is confirm.",
                    "example": "opaque-token"
                  }
                },
                "required": [
                  "operationId",
                  "connectionId"
                ],
                "example": {
                  "payload": {
                    "campaignIdFilter": {
                      "include": [
                        "123456789"
                      ]
                    },
                    "maxResults": 10
                  },
                  "operationId": "ads_manager.sp.list_campaigns",
                  "connectionId": 123
                },
                "additionalProperties": true
              },
              "example": {
                "payload": {
                  "campaignIdFilter": {
                    "include": [
                      "123456789"
                    ]
                  },
                  "maxResults": 10
                },
                "operationId": "ads_manager.sp.list_campaigns",
                "connectionId": 123
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "description": "Safe Amazon Ads provider result.",
                                  "example": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "confirmationToken": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Single-use mutation confirmation token returned by preview.",
                                  "example": "opaque-token"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "expiresAt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Confirmation expiry timestamp when returned.",
                                  "example": 1760000000000
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": {},
                    "confirmationToken": "opaque-token",
                    "expiresAt": 1760000000000
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-advertising",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_advertising",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-asin-keywords/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Asin Keywords",
        "description": "Use Nexscope data to reverse-lookup traffic keywords for any Amazon ASIN, including organic ranking, ad ranking, search volume, traffic share, organic/paid scores, ABA TOP3 click concentration, click conversion rate, year-over-year search volume changes, and weekly/monthly time windows. Trigger when the user mentions ASIN keyword analysis, ASIN reverse lookup, traffic keyword research, organic ranking query, ad ranking query, keyword position tracking, Nexscope keyword data, competitor keyword peeking, viewing which keywords drive traffic to a product, analyzing keyword performance for a specific ASIN, time windows by week/month/recent N days, ASIN reverse keyword lookup, traffic keywords, organic ranking, ad ranking, search volume, Nexscope keywords, competitor keyword reverse lookup, click concentration, click-to-purchase conversion, week-over-week search volume. Even if the user does not explicitly mention \"Nexscope\", if their need involves finding keywords associated with a specific Amazon product (ASIN), this skill should also be triggered.",
        "operationId": "runAmazonAsinKeywords",
        "externalDocs": {
          "description": "Amazon Asin Keywords documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-asin-keywords"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-asin-keywords.",
                "properties": {
                  "asin": {
                    "type": "string",
                    "description": "ASIN code, max length 1000 characters. This tool can only query one ASIN at a time",
                    "example": "B072MQ5BRX"
                  },
                  "country": {
                    "type": "string",
                    "description": "Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA"
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Keyword, max length 1000. Translate to the corresponding country's language whenever possible",
                    "example": "phone case"
                  },
                  "timePieceType": {
                    "type": "string",
                    "description": "Time slice type, default latelyDay. Options: latelyDay (last N days), month (a specific month), week (a specific week)"
                  },
                  "timePieceValue": {
                    "type": "string",
                    "description": "Time slice value, default 7, max length 1000. For latelyDay only 7 or 30; for month format YYYY-MM (e.g. 2026-04); for week format week start date YYYY-MM-DD (e.g. 2026-04-13)"
                  },
                  "conditions": {
                    "type": "string",
                    "description": "Condition filters, comma-separated. Options:<br>Flag type: nfPosition (natural traffic keyword), isSpAd (SP ad keyword), isBrandAd (brand ad keyword), isVedioAd (video ad keyword), isAC (AC recommended keyword), isAccurateKw (precise traffic keyword), isAccurateTailKw (precise long-tail keyword), isPurchaseKw (converting keyword), isQualityKw (high-quality conversion keyword), isStableKw (stable conversion keyword), isLossKw (lost conversion keyword), isInvalidKw (invalid impression keyword), isMultiVariantKw (multi-variant natural rank keyword), isSearchVolUpKw (search volume YoY growth keyword), isSearchVolDownKw (search volume YoY decline keyword)<br>Period count type (.total all / .in new): totalPeriod.in, nfKeywordCnt.total, nfKeywordCnt.in, adKeywordCnt.total, adKeywordCnt.in, allSpKeywordCnt.total, allSpKeywordCnt.in, spKeywordCnt.total, spKeywordCnt.in, recSpKeywordCnt.total, recSpKeywordCnt.in, allSbKeywordCnt.total, allSbKeywordCnt.in, sbKeywordCnt.total, sbKeywordCnt.in, sbvKeywordCnt.total, sbvKeywordCnt.in"
                  },
                  "sortBy": {
                    "type": "string",
                    "description": "Sort field. Options: lastRank (natural rank), adLastRank (ad rank), updateTime (keyword crawl time), searchesRank (search rank), estSearchesNum (monthly search volume). Empty string means default system sort"
                  },
                  "desc": {
                    "type": "boolean",
                    "description": "Whether to sort descending, default true",
                    "example": false
                  },
                  "pageNum": {
                    "type": "integer",
                    "description": "Page number, default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page, min 10, max 100, default 100",
                    "example": 10
                  }
                },
                "required": [
                  "asin"
                ],
                "example": {
                  "asin": "B072MQ5BRX",
                  "pageSize": 10,
                  "desc": true,
                  "pageNum": 1,
                  "country": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "asin": "B072MQ5BRX",
                "pageSize": 10,
                "desc": true,
                "pageNum": 1,
                "country": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of data records actually returned",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Data array (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "keyword": {
                                        "type": "string",
                                        "description": "Keyword",
                                        "example": "phone case"
                                      },
                                      "translateKeyword": {
                                        "type": "string",
                                        "description": "Keyword translation, localized translation for the site",
                                        "example": "phone case"
                                      },
                                      "asin": {
                                        "type": "string",
                                        "description": "Product ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "productNaturalRank": {
                                        "type": "integer",
                                        "description": "Product natural search rank. The position ranking of this product in natural search results for this keyword, e.g. 1 means ranked 1st (top position) in search results",
                                        "example": 1
                                      },
                                      "naturalRankDisplay": {
                                        "type": "string",
                                        "description": "Natural rank display text. String representation of natural search rank",
                                        "example": null
                                      },
                                      "productAdRank": {
                                        "type": "integer",
                                        "description": "Product SP ad rank. The ranking position of this product in Sponsored Products ad placements for this keyword, e.g. 3 means ranked 3rd in ad placement",
                                        "example": 1
                                      },
                                      "adRankDisplay": {
                                        "type": "string",
                                        "description": "Ad rank display text. String representation of SP ad rank",
                                        "example": null
                                      },
                                      "weeklySearchVolume": {
                                        "type": "integer",
                                        "description": "Weekly search volume. Estimated weekly search count for this keyword on Amazon",
                                        "example": 1
                                      },
                                      "keywordPopularityRank": {
                                        "type": "integer",
                                        "description": "Keyword search popularity rank. This keyword's monthly search volume ranking among all Amazon keywords; lower values indicate higher search volume",
                                        "example": 1
                                      },
                                      "totalSearchResultProductCount": {
                                        "type": "integer",
                                        "description": "Total search result product count for this keyword (active listings)",
                                        "example": 1
                                      },
                                      "trafficShare": {
                                        "type": "number",
                                        "description": "Traffic share. Proportion of traffic this keyword brings to the product out of all keywords' total traffic, where 1 = 100%",
                                        "example": 1
                                      },
                                      "naturalTrafficShare": {
                                        "type": "number",
                                        "description": "Natural traffic score share. Natural search traffic score / total score",
                                        "example": 1
                                      },
                                      "paidTrafficShare": {
                                        "type": "number",
                                        "description": "Paid ad traffic score share. Ad traffic score / total score; ad total = sp + sb + sbv + recAd",
                                        "example": 1
                                      },
                                      "naturalTrafficScore": {
                                        "type": "number",
                                        "description": "Natural traffic score. Natural search exposure score this keyword brings to this ASIN; 0 = no natural traffic exposure",
                                        "example": 1
                                      },
                                      "sponsoredProductsScore": {
                                        "type": "number",
                                        "description": "SP ad regular score. Traffic score for Sponsored Products regular placements (excluding SP recommendation placements)",
                                        "example": 1
                                      },
                                      "brandAdScore": {
                                        "type": "number",
                                        "description": "SB brand ad score. Traffic score for Sponsored Brands brand ads (regular + video, combined)",
                                        "example": 1
                                      },
                                      "videoAdScore": {
                                        "type": "number",
                                        "description": "SBV video ad score. Traffic score for Sponsored Brands Video video ads",
                                        "example": 1
                                      },
                                      "sponsoredRecommendationScore": {
                                        "type": "number",
                                        "description": "SP recommendation placement score. Combined score for Trending now / Seen on social media / Customers frequently viewed / 4 stars and above, etc.",
                                        "example": 1
                                      },
                                      "sponsoredRecommendationBreakdown": {
                                        "type": "array",
                                        "description": "SP recommendation placement score breakdown. Each entry {title, score, scoreRatio}",
                                        "example": []
                                      },
                                      "clickConcentrationShare": {
                                        "type": "number",
                                        "description": "ABA TOP3 click concentration. Measures whether clicks are concentrated on top ASINs; note this is not conversion rate",
                                        "example": 1
                                      },
                                      "clickToPurchaseConversionRate": {
                                        "type": "number",
                                        "description": "Click-to-purchase conversion rate (purchaseQty / clickQty)",
                                        "example": 1
                                      },
                                      "displayPositionTypes": {
                                        "type": "array",
                                        "description": "Product display position type array. May contain: natural=natural search result position; ac=Amazon's Choice recommendation position; sp=Sponsored Products ad position; top=top-of-page brand ad position; bottom=bottom-of-page brand ad position; er=Editorial Recommendations position; vedio=video ad position; tr=Top Rated recommendation position; trfob=Top Rated Frequently Bought recommendation position",
                                        "example": []
                                      },
                                      "trafficCharacteristicMarkers": {
                                        "type": "array",
                                        "description": "Keyword traffic characteristic marker array. May contain: isMainKw=main traffic keyword; isAccurateKw=precise traffic keyword; isAccurateAboveKw=precise broad keyword; isAccurateTailKw=precise long-tail keyword",
                                        "example": []
                                      },
                                      "conversionPerformanceMarkers": {
                                        "type": "array",
                                        "description": "Conversion performance marker array. May contain: isPurchaseKw=converting keyword; isQualityKw=high-quality conversion keyword; isStableKw=stable conversion keyword; isLossKw=lost conversion keyword; isInvalidKw=invalid impression keyword",
                                        "example": []
                                      },
                                      "lastNaturalRankTime": {
                                        "type": "string",
                                        "description": "Time of the most recent valid natural rank",
                                        "example": null
                                      },
                                      "lastAdRankTime": {
                                        "type": "string",
                                        "description": "Time of the most recent valid SP ad rank",
                                        "example": null
                                      },
                                      "periodEndDate": {
                                        "type": "string",
                                        "description": "Current period (weekly granularity) end date = start week + 7 days (site time)",
                                        "example": "2026-01-01"
                                      },
                                      "updateTime": {
                                        "type": "string",
                                        "description": "Keyword data update time",
                                        "example": "2026-01-01"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "isParentAsin": {
                              "anyOf": [
                                {
                                  "type": "boolean",
                                  "description": "Whether it is a parent ASIN (pasin)",
                                  "example": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "hasVaiants": {
                              "anyOf": [
                                {
                                  "type": "boolean",
                                  "description": "Whether it has variants",
                                  "example": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "abaCreateDateWeek": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Week date corresponding to the latest weekly ABA data",
                                  "example": "2026-01-01"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Latency (ms)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "keyword": "phone case",
                        "translateKeyword": "phone case",
                        "asin": "B072MQ5BRX",
                        "productNaturalRank": 1,
                        "productAdRank": 1,
                        "weeklySearchVolume": 1,
                        "keywordPopularityRank": 1,
                        "totalSearchResultProductCount": 1,
                        "trafficShare": 1,
                        "naturalTrafficShare": 1,
                        "paidTrafficShare": 1,
                        "naturalTrafficScore": 1,
                        "sponsoredProductsScore": 1,
                        "brandAdScore": 1,
                        "videoAdScore": 1,
                        "sponsoredRecommendationScore": 1,
                        "sponsoredRecommendationBreakdown": [],
                        "clickConcentrationShare": 1,
                        "clickToPurchaseConversionRate": 1,
                        "displayPositionTypes": [],
                        "trafficCharacteristicMarkers": [],
                        "conversionPerformanceMarkers": [],
                        "periodEndDate": "2026-01-01",
                        "updateTime": "2026-01-01"
                      }
                    ],
                    "columns": [],
                    "isParentAsin": false,
                    "hasVaiants": false,
                    "abaCreateDateWeek": "2026-01-01",
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-asin-keywords",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_asin_keywords",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-asin-traffic-summary/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Asin Traffic Summary",
        "description": "Use Nexscope (Search Intelligence Framework) data to analyze ASIN traffic source composition and exposure distribution, covering current period/previous period/newly entered/exited period comparisons. Trigger when the user mentions ASIN traffic sources, traffic structure analysis, organic traffic vs paid traffic share, exposure score breakdown, period comparison, new/exited traffic keywords, competitor traffic analysis, SP ad keyword count, brand ad exposure, Amazon's Choice exposure, editorial recommendation exposure, Top Rated exposure, video ad exposure, organic search exposure ratio, PPC traffic sources, promotional deal traffic sources, recommendation slot structure breakdown, ASIN traffic analysis, traffic sources, organic traffic share, ad traffic share, exposure analysis, traffic structure, period-over-period comparison, keyword churn, Nexscope. Even if the user does not explicitly mention \"Nexscope\", if their need involves analyzing an ASIN's traffic sources, exposure channel distribution, cross-period comparison, or competitor traffic structure comparison, this skill should also be triggered.",
        "operationId": "runAmazonAsinTrafficSummary",
        "externalDocs": {
          "description": "Amazon Asin Traffic Summary documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-asin-traffic-summary"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-asin-traffic-summary.",
                "properties": {
                  "searchValue": {
                    "type": "string",
                    "description": "Search value, ASIN codes, comma-separated, max 10 ASINs, max length 1000 characters",
                    "example": "B072MQ5BRX"
                  },
                  "country": {
                    "type": "string",
                    "description": "Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA"
                  },
                  "last7d": {
                    "type": "boolean",
                    "description": "Whether to get last 7 days data, default true. When false, use startDate/endDate range",
                    "example": false
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system week is used)",
                    "example": "2025-03-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "End date yyyy-MM-dd (paired with startDate)",
                    "example": "2025-03-31"
                  },
                  "conditions": {
                    "type": "string",
                    "description": "Condition filters, comma-separated. Options: nf (natural traffic), sp (SP ads), sb (SB regular), sbv (video ads), ad (ad traffic), acAd (SP recommendation), totalPeriod.in (new incoming traffic keywords)"
                  },
                  "sortBy": {
                    "type": "string",
                    "description": "Sort field. Options: totalKeywordNum (all traffic keywords), naturalKeywordNum (natural traffic keywords), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC recommended keywords), erKeywordNum (ER recommended keywords), trKeywordNum (TR recommended keywords), sumScore (total keyword exposure score), totalNfScore (total natural rank exposure score), totalSpSocre (total SP ad exposure score, note spelling), totalBrandScore (total brand ad exposure score), totalVedioScore (total video ad exposure score), totalAcScore (total AC recommendation exposure score), totalTrScore (total TR recommendation exposure score), totalErScore (total ER recommendation exposure score)"
                  },
                  "pageNum": {
                    "type": "integer",
                    "description": "Page number, default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page, min 10, max 10000, default 10000",
                    "example": 10
                  },
                  "desc": {
                    "type": "boolean",
                    "description": "Whether to sort descending, default true",
                    "example": false
                  }
                },
                "required": [
                  "searchValue"
                ],
                "example": {
                  "last7d": true,
                  "pageSize": 10,
                  "desc": true,
                  "pageNum": 1,
                  "country": "US",
                  "searchValue": "B072MQ5BRX"
                },
                "additionalProperties": true
              },
              "example": {
                "last7d": true,
                "pageSize": 10,
                "desc": true,
                "pageNum": 1,
                "country": "US",
                "searchValue": "B072MQ5BRX"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of data records actually returned",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Return data, ASIN summary object array (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "ASIN code. Amazon Standard Identification Number",
                                        "example": "B072MQ5BRX"
                                      },
                                      "productTitle": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "productCategory": {
                                        "type": "string",
                                        "description": "Product category",
                                        "example": null
                                      },
                                      "productPrice": {
                                        "type": "number",
                                        "description": "Product price",
                                        "example": 1
                                      },
                                      "productImageUrl": {
                                        "type": "string",
                                        "description": "Product main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productFeatures": {
                                        "type": "array",
                                        "description": "Product feature list",
                                        "example": []
                                      },
                                      "customerRatingCount": {
                                        "type": "integer",
                                        "description": "Total customer rating count",
                                        "example": 1
                                      },
                                      "productStarRating": {
                                        "type": "number",
                                        "description": "Product star rating (0-5 stars)",
                                        "example": 1
                                      },
                                      "productRatingScore": {
                                        "type": "number",
                                        "description": "Product rating score value (0-5, as displayed on Amazon page)",
                                        "example": 1
                                      },
                                      "isVariantProduct": {
                                        "type": "boolean",
                                        "description": "Whether it is a variant",
                                        "example": false
                                      },
                                      "recentMonthlySalesBucket": {
                                        "type": "string",
                                        "description": "Recent month sales bucket (only has value in keywordSummary path, e.g. \"300+\" or \"1,000+\")",
                                        "example": null
                                      },
                                      "isMonitored": {
                                        "type": "boolean",
                                        "description": "Whether it is being monitored",
                                        "example": false
                                      },
                                      "monitoringStartTime": {
                                        "type": "string",
                                        "description": "Product monitoring start time",
                                        "example": null
                                      },
                                      "dataPeriodStartDate": {
                                        "type": "string",
                                        "description": "Data period start date (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "totalExposureScore": {
                                        "type": "number",
                                        "description": "Total exposure score. Composite exposure score of this product across all keywords",
                                        "example": 1
                                      },
                                      "totalExposureScorePrev": {
                                        "type": "number",
                                        "description": "Previous period total exposure score",
                                        "example": 1
                                      },
                                      "totalTrafficKeywordCount": {
                                        "type": "integer",
                                        "description": "Total traffic keyword count",
                                        "example": 1
                                      },
                                      "totalTrafficKeywordCountIn": {
                                        "type": "integer",
                                        "description": "New incoming traffic keyword count for this period",
                                        "example": 1
                                      },
                                      "totalTrafficKeywordCountOut": {
                                        "type": "integer",
                                        "description": "Outgoing traffic keyword count for this period",
                                        "example": 1
                                      },
                                      "totalTrafficKeywordCountPrev": {
                                        "type": "integer",
                                        "description": "Previous period total traffic keyword count",
                                        "example": 1
                                      },
                                      "naturalSearchExposureScore": {
                                        "type": "number",
                                        "description": "Natural search exposure total score",
                                        "example": 1
                                      },
                                      "naturalSearchExposureRatio": {
                                        "type": "number",
                                        "description": "Natural search exposure ratio",
                                        "example": 1
                                      },
                                      "naturalSearchExposureScorePrev": {
                                        "type": "number",
                                        "description": "Previous period natural search exposure score",
                                        "example": 1
                                      },
                                      "naturalSearchKeywordCount": {
                                        "type": "integer",
                                        "description": "Natural search keyword count",
                                        "example": 1
                                      },
                                      "naturalSearchKeywordCountIn": {
                                        "type": "integer",
                                        "description": "New incoming natural search keyword count for this period",
                                        "example": 1
                                      },
                                      "naturalSearchKeywordCountOut": {
                                        "type": "integer",
                                        "description": "Outgoing natural search keyword count for this period",
                                        "example": 1
                                      },
                                      "naturalSearchKeywordCountPrev": {
                                        "type": "integer",
                                        "description": "Previous period natural search keyword count",
                                        "example": 1
                                      },
                                      "sponsoredProductsExposureScore": {
                                        "type": "number",
                                        "description": "SP ad exposure total score",
                                        "example": 1
                                      },
                                      "sponsoredProductsExposureRatio": {
                                        "type": "number",
                                        "description": "SP ad exposure ratio",
                                        "example": 1
                                      },
                                      "sponsoredProductsExposureScorePrev": {
                                        "type": "number",
                                        "description": "Previous period SP ad exposure score",
                                        "example": 1
                                      },
                                      "sponsoredProductsKeywordCount": {
                                        "type": "integer",
                                        "description": "SP ad keyword count",
                                        "example": 1
                                      },
                                      "brandAdExposureScore": {
                                        "type": "number",
                                        "description": "Brand ad exposure total score",
                                        "example": 1
                                      },
                                      "brandAdExposureRatio": {
                                        "type": "number",
                                        "description": "Brand ad exposure ratio",
                                        "example": 1
                                      },
                                      "brandAdExposureScorePrev": {
                                        "type": "number",
                                        "description": "Previous period brand ad exposure score",
                                        "example": 1
                                      },
                                      "brandAdKeywordCount": {
                                        "type": "integer",
                                        "description": "Total brand ad keyword count",
                                        "example": 1
                                      },
                                      "topBrandAdKeywordCount": {
                                        "type": "integer",
                                        "description": "Top-of-page brand ad keyword count",
                                        "example": 1
                                      },
                                      "bottomBrandAdKeywordCount": {
                                        "type": "integer",
                                        "description": "Bottom-of-page brand ad keyword count",
                                        "example": 1
                                      },
                                      "videoAdExposureScore": {
                                        "type": "number",
                                        "description": "Video ad exposure total score",
                                        "example": 1
                                      },
                                      "videoAdExposureRatio": {
                                        "type": "number",
                                        "description": "Video ad exposure ratio",
                                        "example": 1
                                      },
                                      "videoAdExposureScorePrev": {
                                        "type": "number",
                                        "description": "Previous period video ad exposure score",
                                        "example": 1
                                      },
                                      "videoAdKeywordCount": {
                                        "type": "integer",
                                        "description": "Video ad keyword count",
                                        "example": 1
                                      },
                                      "amazonsChoiceExposureScore": {
                                        "type": "number",
                                        "description": "Amazon's Choice exposure total score",
                                        "example": 1
                                      },
                                      "amazonsChoiceExposureRatio": {
                                        "type": "number",
                                        "description": "Amazon's Choice exposure ratio",
                                        "example": 1
                                      },
                                      "amazonsChoiceExposureScorePrev": {
                                        "type": "number",
                                        "description": "Previous period AC exposure score",
                                        "example": 1
                                      },
                                      "amazonsChoiceKeywordCount": {
                                        "type": "integer",
                                        "description": "Amazon's Choice keyword count",
                                        "example": 1
                                      },
                                      "amazonsChoiceKeywordCountIn": {
                                        "type": "integer",
                                        "description": "New incoming AC keyword count for this period",
                                        "example": 1
                                      },
                                      "amazonsChoiceKeywordCountOut": {
                                        "type": "integer",
                                        "description": "Outgoing AC keyword count for this period",
                                        "example": 1
                                      },
                                      "editorialRecommendationsExposureScore": {
                                        "type": "number",
                                        "description": "Editorial Recommendations exposure total score",
                                        "example": 1
                                      },
                                      "editorialRecommendationsExposureRatio": {
                                        "type": "number",
                                        "description": "Editorial Recommendations exposure ratio",
                                        "example": 1
                                      },
                                      "editorialRecommendationsKeywordCount": {
                                        "type": "integer",
                                        "description": "Editorial Recommendations keyword count",
                                        "example": 1
                                      },
                                      "topRatedExposureScore": {
                                        "type": "number",
                                        "description": "Top Rated recommendation exposure total score",
                                        "example": 1
                                      },
                                      "topRatedExposureRatio": {
                                        "type": "number",
                                        "description": "Top Rated recommendation exposure ratio",
                                        "example": 1
                                      },
                                      "topRatedKeywordCount": {
                                        "type": "integer",
                                        "description": "Top Rated recommendation keyword count",
                                        "example": 1
                                      },
                                      "frequentlyBoughtKeywordCount": {
                                        "type": "integer",
                                        "description": "Frequently Bought recommendation keyword count (Top Rated Frequently Bought)",
                                        "example": 1
                                      },
                                      "recommendPositionExposureScore": {
                                        "type": "number",
                                        "description": "Recommendation position exposure total score",
                                        "example": 1
                                      },
                                      "recommendAdExposureScore": {
                                        "type": "number",
                                        "description": "Recommendation position ad exposure score",
                                        "example": 1
                                      },
                                      "recommendNonadExposureScore": {
                                        "type": "number",
                                        "description": "Recommendation position non-ad exposure score",
                                        "example": 1
                                      },
                                      "nonAcRecommendExposureScore": {
                                        "type": "number",
                                        "description": "Non-AC recommendation position exposure score",
                                        "example": 1
                                      },
                                      "recommendKeywordCount": {
                                        "type": "integer",
                                        "description": "Total recommendation position keyword count",
                                        "example": 1
                                      },
                                      "recommendAdKeywordCount": {
                                        "type": "integer",
                                        "description": "Recommendation position ad keyword count",
                                        "example": 1
                                      },
                                      "recommendNonadKeywordCount": {
                                        "type": "integer",
                                        "description": "Recommendation position non-ad keyword count",
                                        "example": 1
                                      },
                                      "ppcTrafficSources": {
                                        "type": "array",
                                        "description": "PPC paid ad traffic source markers. Contains: SP ads, top brand ads, bottom brand ads, video ads",
                                        "example": []
                                      },
                                      "naturalSearchTrafficSources": {
                                        "type": "array",
                                        "description": "Natural search traffic source markers",
                                        "example": []
                                      },
                                      "amazonRecommendationSources": {
                                        "type": "array",
                                        "description": "Amazon recommendation traffic source markers. Contains: Best Seller, AC, ER, TR, TRFOB, etc.",
                                        "example": []
                                      },
                                      "promotionalDealSources": {
                                        "type": "array",
                                        "description": "Promotional deal traffic source markers. Contains: Coupon, Limited Time Deal, Lowest Price in 30 Days, etc.",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "isParentAsin": {
                              "anyOf": [
                                {
                                  "type": "boolean",
                                  "description": "Whether the search value is a parent ASIN",
                                  "example": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "variantsNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of variant products with keywords",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "noKeywordVariantsNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of variant products without keywords",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Latency (ms)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "asin": "B072MQ5BRX",
                        "productPrice": 1,
                        "productImageUrl": "https://example.com/image.jpg",
                        "productFeatures": [],
                        "customerRatingCount": 1,
                        "productStarRating": 1,
                        "productRatingScore": 1,
                        "isVariantProduct": false,
                        "isMonitored": false,
                        "dataPeriodStartDate": "2026-01-01",
                        "totalExposureScore": 1,
                        "totalExposureScorePrev": 1,
                        "totalTrafficKeywordCount": 1,
                        "totalTrafficKeywordCountIn": 1,
                        "totalTrafficKeywordCountOut": 1,
                        "totalTrafficKeywordCountPrev": 1,
                        "naturalSearchExposureScore": 1,
                        "naturalSearchExposureRatio": 1,
                        "naturalSearchExposureScorePrev": 1,
                        "naturalSearchKeywordCount": 1,
                        "naturalSearchKeywordCountIn": 1,
                        "naturalSearchKeywordCountOut": 1,
                        "naturalSearchKeywordCountPrev": 1,
                        "sponsoredProductsExposureScore": 1,
                        "sponsoredProductsExposureRatio": 1,
                        "sponsoredProductsExposureScorePrev": 1,
                        "sponsoredProductsKeywordCount": 1,
                        "brandAdExposureScore": 1,
                        "brandAdExposureRatio": 1,
                        "brandAdExposureScorePrev": 1,
                        "brandAdKeywordCount": 1,
                        "topBrandAdKeywordCount": 1,
                        "bottomBrandAdKeywordCount": 1,
                        "videoAdExposureScore": 1,
                        "videoAdExposureRatio": 1,
                        "videoAdExposureScorePrev": 1,
                        "videoAdKeywordCount": 1,
                        "amazonsChoiceExposureScore": 1,
                        "amazonsChoiceExposureRatio": 1,
                        "amazonsChoiceExposureScorePrev": 1,
                        "amazonsChoiceKeywordCount": 1,
                        "amazonsChoiceKeywordCountIn": 1,
                        "amazonsChoiceKeywordCountOut": 1,
                        "editorialRecommendationsExposureScore": 1,
                        "editorialRecommendationsExposureRatio": 1,
                        "editorialRecommendationsKeywordCount": 1,
                        "topRatedExposureScore": 1,
                        "topRatedExposureRatio": 1,
                        "topRatedKeywordCount": 1,
                        "frequentlyBoughtKeywordCount": 1,
                        "recommendPositionExposureScore": 1,
                        "recommendAdExposureScore": 1,
                        "recommendNonadExposureScore": 1,
                        "nonAcRecommendExposureScore": 1,
                        "recommendKeywordCount": 1,
                        "recommendAdKeywordCount": 1,
                        "recommendNonadKeywordCount": 1,
                        "ppcTrafficSources": [],
                        "naturalSearchTrafficSources": [],
                        "amazonRecommendationSources": [],
                        "promotionalDealSources": []
                      }
                    ],
                    "columns": [],
                    "isParentAsin": false,
                    "variantsNum": 1,
                    "noKeywordVariantsNum": 1,
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-asin-traffic-summary",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_asin_traffic_summary",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-broad-product-search/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Broad Product Search",
        "description": "Use Nexscope data to search and filter Amazon products, supporting multi-dimensional criteria including price, monthly sales, BSR ranking, gross margin, ratings, fulfillment method, badges, seller origin, and more across multiple Amazon marketplaces. Trigger when the user mentions Amazon product selection research, product filtering, sales filtering, product discovery, BSR analysis, niche product discovery, competitor analysis, market opportunity assessment, product-level market size estimation, gross margin screening, Nexscope product selection, Amazon product selection, sales filtering, BSR analysis, profit screening, market analysis, product selection tool. Even if the user does not explicitly mention \"Nexscope\", if their need involves filtering and analyzing Amazon product-level data for product selection, this skill should also be triggered.",
        "operationId": "runAmazonBroadProductSearch",
        "externalDocs": {
          "description": "Amazon Broad Product Search documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-broad-product-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-broad-product-search.",
                "properties": {
                  "chatId": {
                    "type": "string",
                    "description": "Chat ID, maxLength 1000",
                    "example": "example-id"
                  },
                  "uid": {
                    "type": "string",
                    "description": "User ID, maxLength 1000",
                    "example": "example-id"
                  },
                  "requestId": {
                    "type": "string",
                    "description": "Push ID, maxLength 1000",
                    "example": "example-id"
                  },
                  "teamId": {
                    "type": "string",
                    "description": "Team ID, maxLength 1000",
                    "example": "example-id"
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Search keyword; translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc.; maxLength 10240",
                    "example": "phone case"
                  },
                  "matchType": {
                    "type": "integer",
                    "description": "Match type: 1 = phrase match (default), 2 = fuzzy match, 3 = exact match",
                    "example": 1
                  },
                  "excludeKeywords": {
                    "type": "string",
                    "description": "Exclude keywords; maxLength 10240",
                    "example": "phone case"
                  },
                  "marketplace": {
                    "type": "string",
                    "description": "Marketplace site code, default US. Only US, UK, DE, FR, JP, CA, IT, ES, MX, IN are allowed (must match this enum; AU, TR, and other unlisted sites are not supported)",
                    "example": "US"
                  },
                  "nodeLabel": {
                    "type": "string",
                    "description": "Amazon category name; maxLength 1000"
                  },
                  "nodeIdPath": {
                    "type": "string",
                    "description": "Amazon category node ID; maxLength 1000"
                  },
                  "filterSubNode": {
                    "type": "boolean",
                    "description": "Whether to filter subcategory nodes; only effective when nodeLabel or nodeIdPath has a value; pass JSON boolean true / false",
                    "example": false
                  },
                  "dataSnapshotMonth": {
                    "type": "string",
                    "description": "Product data snapshot month, format yyyyMM (e.g. 202412 for December 2024 data snapshot), or nearly for last 30 days real-time data. Default: nearly. Used for historical analysis and period comparison; only supports existing historical snapshots, future dates are not supported; maxLength 1000"
                  },
                  "minPrice": {
                    "type": "number",
                    "description": "Minimum price (>= 0)",
                    "example": 1
                  },
                  "maxPrice": {
                    "type": "number",
                    "description": "Maximum price (>= 0)",
                    "example": 1
                  },
                  "minProfit": {
                    "type": "number",
                    "description": "Minimum gross margin, unit % (1-100)",
                    "example": 1
                  },
                  "maxProfit": {
                    "type": "number",
                    "description": "Maximum gross margin, unit % (1-100)",
                    "example": 1
                  },
                  "minRevenue": {
                    "type": "number",
                    "description": "Minimum monthly sales revenue (>= 0)",
                    "example": 1
                  },
                  "maxRevenue": {
                    "type": "number",
                    "description": "Maximum monthly sales revenue (>= 0)",
                    "example": 1
                  },
                  "minFba": {
                    "type": "number",
                    "description": "Minimum FBA shipping fee (>= 0)",
                    "example": 1
                  },
                  "maxFba": {
                    "type": "number",
                    "description": "Maximum FBA shipping fee (>= 0)",
                    "example": 1
                  },
                  "minUnits": {
                    "type": "integer",
                    "description": "Minimum monthly sales volume (>= 0)",
                    "example": 1
                  },
                  "maxUnits": {
                    "type": "integer",
                    "description": "Maximum monthly sales volume (>= 0)",
                    "example": 1
                  },
                  "minAmzUnit": {
                    "type": "integer",
                    "description": "Minimum variant last-30-day sales volume (only supported when dataSnapshotMonth is a \"last 30 days\" type query); minimum 0",
                    "example": 1
                  },
                  "maxAmzUnit": {
                    "type": "integer",
                    "description": "Maximum variant last-30-day sales volume (only supported for last 30 days queries); minimum 0",
                    "example": 1
                  },
                  "minUnitsGrowthRate": {
                    "type": "number",
                    "description": "Minimum monthly sales volume growth rate, unit %",
                    "example": 1
                  },
                  "maxUnitsGrowthRate": {
                    "type": "number",
                    "description": "Maximum monthly sales volume growth rate, unit %",
                    "example": 1
                  },
                  "minBsr": {
                    "type": "integer",
                    "description": "Lowest main category BSR rank",
                    "example": 1
                  },
                  "maxBsr": {
                    "type": "integer",
                    "description": "Highest main category BSR rank",
                    "example": 1
                  },
                  "minBsrGrowthRate": {
                    "type": "number",
                    "description": "Minimum BSR growth rate, unit %",
                    "example": 1
                  },
                  "maxBsrGrowthRate": {
                    "type": "number",
                    "description": "Maximum BSR growth rate, unit %",
                    "example": 1
                  },
                  "minBsrGrowthCount": {
                    "type": "integer",
                    "description": "Minimum BSR growth count",
                    "example": 1
                  },
                  "maxBsrGrowthCount": {
                    "type": "integer",
                    "description": "Maximum main category BSR growth count",
                    "example": 1
                  },
                  "minSubNodeBsrRank": {
                    "type": "integer",
                    "description": "Lowest subcategory BSR rank (requires filterSubNode = true)",
                    "example": 1
                  },
                  "maxSubNodeBsrRank": {
                    "type": "integer",
                    "description": "Highest subcategory BSR rank (requires filterSubNode = true)",
                    "example": 1
                  },
                  "minRating": {
                    "type": "number",
                    "description": "Minimum rating value (0-5)",
                    "example": 1
                  },
                  "maxRating": {
                    "type": "number",
                    "description": "Maximum rating value (0-5), 3.8-4.3 is the product improvement opportunity range",
                    "example": 1
                  },
                  "minRatings": {
                    "type": "integer",
                    "description": "Minimum review count (0-10000)",
                    "example": 1
                  },
                  "maxRatings": {
                    "type": "integer",
                    "description": "Maximum review count (0-10000)",
                    "example": 1
                  },
                  "minRatingsGrowthCount": {
                    "type": "integer",
                    "description": "Minimum monthly new review count (>= 0)",
                    "example": 1
                  },
                  "maxRatingsGrowthCount": {
                    "type": "integer",
                    "description": "Maximum monthly new review count (>= 0)",
                    "example": 1
                  },
                  "minListingQualityScore": {
                    "type": "number",
                    "description": "Minimum Listing page quality score (>= 0)",
                    "example": 1
                  },
                  "maxListingQualityScore": {
                    "type": "number",
                    "description": "Maximum Listing page quality score (>= 0)",
                    "example": 1
                  },
                  "minVariations": {
                    "type": "integer",
                    "description": "Minimum number of variations",
                    "example": 1
                  },
                  "maxVariations": {
                    "type": "integer",
                    "description": "Maximum number of variations",
                    "example": 1
                  },
                  "minWeights": {
                    "type": "number",
                    "description": "Minimum weight (>= 0)",
                    "example": 1
                  },
                  "maxWeights": {
                    "type": "number",
                    "description": "Maximum weight (>= 0)",
                    "example": 1
                  },
                  "weightUnit": {
                    "type": "string",
                    "description": "Weight unit: g, kg, oz, lb. This field must be specified if the parameters include weight filtering"
                  },
                  "dimensionType": {
                    "type": "string",
                    "description": "Package dimension type (codes vary by site, see below)"
                  },
                  "minSellers": {
                    "type": "integer",
                    "description": "Minimum number of sellers",
                    "example": 1
                  },
                  "maxSellers": {
                    "type": "integer",
                    "description": "Maximum number of sellers",
                    "example": 1
                  },
                  "badgeBestSeller": {
                    "type": "string",
                    "description": "Best Seller badge filter: Y, N, or empty (all)"
                  },
                  "badgeAmazonsChoice": {
                    "type": "string",
                    "description": "Amazon's Choice badge filter: Y, N, or empty (all)"
                  },
                  "badgeNewRelease": {
                    "type": "string",
                    "description": "New Release badge filter: Y, N, or empty (all)"
                  },
                  "fulfillment": {
                    "type": "string",
                    "description": "Fulfillment method: single select AMZ / FBA / FBM, or multi-select such as AMZ,FBA, FBA,FBM, AMZ,FBA,FBM, etc.; multiple conditions use comma separation; empty means no limit"
                  },
                  "showVariation": {
                    "type": "string",
                    "description": "Whether to query variants: Y or N, default N"
                  },
                  "hideUnlistedProduct": {
                    "type": "boolean",
                    "description": "Whether to hide delisted products, default true",
                    "example": false
                  },
                  "listedWithinLastMonths": {
                    "type": "integer",
                    "description": "Time since listing (months), only allowed: 1, 3, 6, 12, 24 (must match these enum values; do not pass other integers)",
                    "example": 1
                  },
                  "sellerNation": {
                    "type": "string",
                    "description": "Seller location code (e.g. US, CN, HK), multiple conditions comma-separated, default no limit"
                  },
                  "includeSellers": {
                    "type": "string",
                    "description": "Include sellers; maxLength 10240"
                  },
                  "excludeSellers": {
                    "type": "string",
                    "description": "Exclude sellers; maxLength 10240"
                  },
                  "includeBrands": {
                    "type": "string",
                    "description": "Include brands; maxLength 10240"
                  },
                  "excludeBrands": {
                    "type": "string",
                    "description": "Exclude brands; maxLength 10240"
                  },
                  "order": {
                    "type": "object",
                    "description": "Sort configuration; if passed, it is recommended to provide both field and desc (both are required in the sub-schema)",
                    "example": {},
                    "properties": {
                      "field": {
                        "type": "string",
                        "description": "Sort field: total_units (monthly sales), total_amount (monthly revenue), bsr_rank, price, rating, reviews, profit, reviews_rate, available_date, questions, total_units_growth, total_amount_growth, reviews_increasement, bsr_rank_cv, bsr_rank_cr, amz_unit (variant sales). Default total_units. Pass an empty string \"\" to not sort by the above business fields (full query sort semantics are handled by the server)"
                      },
                      "desc": {
                        "type": "string",
                        "description": "\"true\" descending, \"false\" ascending; default \"true\"; maxLength 1000"
                      }
                    },
                    "additionalProperties": true
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting from 1, default 1",
                    "example": 1
                  },
                  "size": {
                    "type": "integer",
                    "description": "Results per page (10-100), default 20",
                    "example": 20
                  }
                },
                "example": {
                  "marketplace": "US",
                  "matchType": 1,
                  "keyword": "phone case",
                  "size": 20,
                  "page": 1
                },
                "additionalProperties": true
              },
              "example": {
                "marketplace": "US",
                "matchType": 1,
                "keyword": "phone case",
                "size": 20,
                "page": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total matching product count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see product object fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nodeIdPath": {
                                        "type": "string",
                                        "description": "Node ID path",
                                        "example": null
                                      },
                                      "nodeLabel": {
                                        "type": "string",
                                        "description": "Amazon category name",
                                        "example": null
                                      },
                                      "asin": {
                                        "type": "string",
                                        "description": "Amazon ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Amazon product detail page URL",
                                        "example": "B072MQ5BRX"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current price",
                                        "example": 1
                                      },
                                      "averagePrice": {
                                        "type": "number",
                                        "description": "Average price",
                                        "example": 1
                                      },
                                      "primePrice": {
                                        "type": "number",
                                        "description": "Prime price, -1 means not available",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Monthly sales volume",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Monthly sales revenue",
                                        "example": 1
                                      },
                                      "monthlySalesUnitsGrowthRate": {
                                        "type": "number",
                                        "description": "Monthly sales volume growth rate",
                                        "example": 1
                                      },
                                      "bsr": {
                                        "type": "integer",
                                        "description": "BSR rank",
                                        "example": 1
                                      },
                                      "bsrGrowthRate": {
                                        "type": "number",
                                        "description": "BSR growth rate",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "ratingsRate": {
                                        "type": "number",
                                        "description": "Review rate",
                                        "example": 1
                                      },
                                      "profit": {
                                        "type": "number",
                                        "description": "Gross margin (%)",
                                        "example": 1
                                      },
                                      "fba": {
                                        "type": "number",
                                        "description": "FBA shipping fee",
                                        "example": 1
                                      },
                                      "sellerNum": {
                                        "type": "integer",
                                        "description": "Number of sellers",
                                        "example": 1
                                      },
                                      "sellerId": {
                                        "type": "string",
                                        "description": "BuyBox seller ID",
                                        "example": "example-id"
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "BuyBox seller name",
                                        "example": null
                                      },
                                      "sellerNation": {
                                        "type": "string",
                                        "description": "BuyBox seller nationality",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "brandUrl": {
                                        "type": "string",
                                        "description": "Brand page URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "fulfillment": {
                                        "type": "string",
                                        "description": "Fulfillment method (AMZ / FBA / FBM)",
                                        "example": null
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time (timestamp)",
                                        "example": "2026-01-01"
                                      },
                                      "availableDateString": {
                                        "type": "string",
                                        "description": "Listing date (formatted string)",
                                        "example": "2026-01-01"
                                      },
                                      "variationNum": {
                                        "type": "integer",
                                        "description": "Number of variations",
                                        "example": 1
                                      },
                                      "variant30DayUnits": {
                                        "type": "integer",
                                        "description": "Variant monthly sales (units)",
                                        "example": 1
                                      },
                                      "variant30DayRevenue": {
                                        "type": "number",
                                        "description": "Variant monthly sales revenue (amount)",
                                        "example": 1
                                      },
                                      "variant30DayUpdatedAt": {
                                        "type": "string",
                                        "description": "Variant data update time",
                                        "example": "2026-01-01"
                                      },
                                      "weight": {
                                        "type": "string",
                                        "description": "Weight",
                                        "example": null
                                      },
                                      "packageWeight": {
                                        "type": "string",
                                        "description": "Package weight",
                                        "example": null
                                      },
                                      "dimension": {
                                        "type": "string",
                                        "description": "Dimensions",
                                        "example": null
                                      },
                                      "packageDimensions": {
                                        "type": "string",
                                        "description": "Package dimensions",
                                        "example": null
                                      },
                                      "dimensionsType": {
                                        "type": "string",
                                        "description": "Dimension type",
                                        "example": null
                                      },
                                      "packageDimensionType": {
                                        "type": "string",
                                        "description": "Package dimension type",
                                        "example": null
                                      },
                                      "listingQualityScore": {
                                        "type": "number",
                                        "description": "Listing quality score",
                                        "example": 1
                                      },
                                      "deliveryPrice": {
                                        "type": "number",
                                        "description": "Seller shipping fee, -1 means not available",
                                        "example": 1
                                      },
                                      "nodeLabelPath": {
                                        "type": "string",
                                        "description": "Category path",
                                        "example": null
                                      },
                                      "nodeId": {
                                        "type": "integer",
                                        "description": "Node ID",
                                        "example": 1
                                      },
                                      "dataSnapshotMonth": {
                                        "type": "string",
                                        "description": "Data query month",
                                        "example": null
                                      },
                                      "badgeBestSeller": {
                                        "type": "string",
                                        "description": "Best Seller badge (Y/N)",
                                        "example": null
                                      },
                                      "badgeAmazonChoice": {
                                        "type": "string",
                                        "description": "Amazon's Choice badge (Y/N)",
                                        "example": null
                                      },
                                      "badgeNewRelease": {
                                        "type": "string",
                                        "description": "New Release badge (Y/N)",
                                        "example": null
                                      },
                                      "badgeVideo": {
                                        "type": "string",
                                        "description": "Video introduction (Y/N)",
                                        "example": null
                                      },
                                      "badgeEbc": {
                                        "type": "string",
                                        "description": "A+ page (Y/N)",
                                        "example": null
                                      },
                                      "badge": {
                                        "type": "object",
                                        "description": "Badge summary object, containing: bestSeller, amazonChoice, newRelease, video, ebc",
                                        "example": {}
                                      },
                                      "subcategories": {
                                        "type": "array",
                                        "description": "Subcategory list, each entry containing code (category code), rank (rank), label (name)",
                                        "example": []
                                      },
                                      "sku": {
                                        "type": "string",
                                        "description": "SKU",
                                        "example": null
                                      },
                                      "keyword": {
                                        "type": "string",
                                        "description": "Matching keyword",
                                        "example": "phone case"
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source type",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "keyword": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Search keyword used (if any)",
                                  "example": "phone case"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data query month",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type (e.g. \"amazon\")",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "asinUrl": "B072MQ5BRX",
                        "imageUrl": "https://example.com/image.jpg",
                        "price": 1,
                        "averagePrice": 1,
                        "primePrice": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "monthlySalesUnitsGrowthRate": 1,
                        "bsr": 1,
                        "bsrGrowthRate": 1,
                        "rating": 1,
                        "ratings": 1,
                        "ratingsRate": 1,
                        "profit": 1,
                        "fba": 1,
                        "sellerNum": 1,
                        "sellerId": "example-id",
                        "brandUrl": "https://example.com/image.jpg",
                        "availableDate": "2026-01-01",
                        "availableDateString": "2026-01-01",
                        "variationNum": 1,
                        "variant30DayUnits": 1,
                        "variant30DayRevenue": 1,
                        "variant30DayUpdatedAt": "2026-01-01",
                        "listingQualityScore": 1,
                        "deliveryPrice": 1,
                        "nodeId": 1,
                        "badge": {},
                        "subcategories": [],
                        "keyword": "phone case"
                      }
                    ],
                    "columns": [],
                    "keyword": "phone case",
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-broad-product-search",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_broad_product_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-category-lookup/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Category Lookup",
        "description": "Supports exact parent-node browsing and label-based category search.",
        "operationId": "runAmazonCategoryLookup",
        "externalDocs": {
          "description": "Amazon Category Lookup documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-category-lookup"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Use lookup to browse nodes. Use like with nodeLabel to search category names.",
                "properties": {
                  "operation": {
                    "type": "string",
                    "description": "lookup (default) or like.",
                    "example": "lookup"
                  },
                  "marketId": {
                    "type": "string",
                    "description": "Amazon marketplace or site identifier.",
                    "example": "1"
                  },
                  "nodeId": {
                    "type": "string",
                    "description": "Parent category node identifier.",
                    "example": "0"
                  },
                  "table": {
                    "type": "string",
                    "description": "Optional upstream category table selector.",
                    "example": "nodes"
                  },
                  "nodeLabel": {
                    "type": "string",
                    "description": "Category label required by operation=like.",
                    "example": "Electronics"
                  }
                },
                "example": {
                  "marketId": "1",
                  "operation": "lookup",
                  "nodeId": "0"
                },
                "additionalProperties": true
              },
              "example": {
                "marketId": "1",
                "operation": "lookup",
                "nodeId": "0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of returned category nodes.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Amazon category node records.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nodeId": {
                                        "type": "string",
                                        "description": "Category node identifier.",
                                        "example": "172282"
                                      },
                                      "nodeLabel": {
                                        "type": "string",
                                        "description": "Category label.",
                                        "example": "Electronics"
                                      },
                                      "parentNodeId": {
                                        "type": "string",
                                        "description": "Parent node identifier.",
                                        "example": "0"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Provider-reported token cost.",
                                  "example": 150
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "nodeId": "172282",
                        "nodeLabel": "Electronics",
                        "parentNodeId": "0"
                      }
                    ],
                    "costToken": 150
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-category-lookup",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_category_lookup",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-competitor-lookup/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Competitor Lookup",
        "description": "Use Nexscope data to find and analyze competitors on Amazon, covering 12 marketplaces, with product metrics including sales, BSR, pricing, ratings, and growth trends. Trigger when the user mentions competitor lookup, competitor analysis, ASIN reverse lookup, competitive product research, finding similar products, market competitor discovery, product benchmarking, competitor sales estimation, analyzing competitor listings, competitor analysis, ASIN reverse lookup, competitor sales, competitor research, Nexscope, market competitor discovery, competitor trends. Even if the user does not explicitly mention \"Nexscope\" or \"competitor lookup\", if their need involves discovering and analyzing Amazon competitors by ASIN, keyword, seller name, brand, or category, this skill should also be triggered.",
        "operationId": "runAmazonCompetitorLookup",
        "externalDocs": {
          "description": "Amazon Competitor Lookup documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-competitor-lookup"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-competitor-lookup.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Amazon site code, default US. Options: US, UK, DE, FR, JP, CA, IT, ES, MX, AU, TR, IN",
                    "example": "US"
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Search keyword. Translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc.",
                    "example": "phone case"
                  },
                  "asinList": {
                    "type": "string",
                    "description": "ASINs, multiple ASINs comma-separated, max 40. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$",
                    "example": "B072MQ5BRX"
                  },
                  "sellerName": {
                    "type": "string",
                    "description": "Seller name filter"
                  },
                  "brand": {
                    "type": "string",
                    "description": "Brand name filter"
                  },
                  "nodeLabel": {
                    "type": "string",
                    "description": "Amazon category name, supports multi-level category names, levels separated by colon :, e.g. Electronics:Headphones"
                  },
                  "nodeIdPath": {
                    "type": "string",
                    "description": "Amazon category ID path"
                  },
                  "matchType": {
                    "type": "integer",
                    "description": "Match type. 1 = phrase match (default), 2 = fuzzy match, 3 = exact match",
                    "example": 1
                  },
                  "showVariation": {
                    "type": "string",
                    "description": "Whether to query variants. Y = yes, N = no (default)"
                  },
                  "dataSnapshotMonth": {
                    "type": "string",
                    "description": "Amazon product data snapshot month. Default nearly (queries last 30 days real-time data). Use yyyyMM format to query historical snapshots (e.g. 202412 for December 2024). Only supports existing historical snapshots, future dates are not supported. Recommended for seasonal analysis to query the same period last year's snapshot for comparison"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting from 1 (default 1)",
                    "example": 1
                  },
                  "size": {
                    "type": "integer",
                    "description": "Results per page, returns 10-100 records (default 50)",
                    "example": 10
                  },
                  "order": {
                    "type": "object",
                    "description": "Sort configuration (see below)",
                    "example": {},
                    "properties": {},
                    "additionalProperties": true
                  }
                },
                "example": {
                  "page": 1,
                  "keyword": "phone case",
                  "marketplace": "US",
                  "size": 10,
                  "matchType": 1,
                  "asinList": "B072MQ5BRX"
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "phone case",
                "marketplace": "US",
                "size": 10,
                "matchType": 1,
                "asinList": "B072MQ5BRX"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total matching result count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type (e.g. amazon)",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Competitor list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nodeLabel": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "description": "Category name echo",
                                            "example": null
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "asin": {
                                        "type": "string",
                                        "description": "Product ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current price",
                                        "example": 1
                                      },
                                      "primePrice": {
                                        "type": "number",
                                        "description": "Prime price",
                                        "example": 1
                                      },
                                      "averagePrice": {
                                        "type": "number",
                                        "description": "Average price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Monthly sales volume (units)",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Monthly sales revenue",
                                        "example": 1
                                      },
                                      "monthlySalesUnitsGrowthRate": {
                                        "type": "number",
                                        "description": "Monthly sales volume growth rate",
                                        "example": 1
                                      },
                                      "bsr": {
                                        "type": "integer",
                                        "description": "BSR rank",
                                        "example": 1
                                      },
                                      "bsrGrowthRate": {
                                        "type": "number",
                                        "description": "BSR growth rate",
                                        "example": 1
                                      },
                                      "bsrGrowthCount": {
                                        "type": "integer",
                                        "description": "BSR growth count",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "ratingsGrowth": {
                                        "type": "integer",
                                        "description": "Monthly new review count",
                                        "example": 1
                                      },
                                      "ratingsRate": {
                                        "type": "number",
                                        "description": "Review rate",
                                        "example": 1
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "brandUrl": {
                                        "type": "string",
                                        "description": "Brand URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "BuyBox seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "string",
                                        "description": "BuyBox seller ID",
                                        "example": "example-id"
                                      },
                                      "sellerNation": {
                                        "type": "string",
                                        "description": "BuyBox seller nationality",
                                        "example": null
                                      },
                                      "sellerNum": {
                                        "type": "integer",
                                        "description": "Number of sellers",
                                        "example": 1
                                      },
                                      "fulfillment": {
                                        "type": "string",
                                        "description": "Fulfillment method: AMZ, FBA, FBM",
                                        "example": null
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time (date format)",
                                        "example": "2026-01-01"
                                      },
                                      "availableDateString": {
                                        "type": "string",
                                        "description": "Listing date (string format)",
                                        "example": "2026-01-01"
                                      },
                                      "profit": {
                                        "type": "number",
                                        "description": "Gross margin",
                                        "example": 1
                                      },
                                      "fba": {
                                        "type": "number",
                                        "description": "FBA shipping fee",
                                        "example": 1
                                      },
                                      "deliveryPrice": {
                                        "type": "number",
                                        "description": "Seller shipping fee",
                                        "example": 1
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "parent": {
                                        "type": "string",
                                        "description": "Parent ASIN",
                                        "example": null
                                      },
                                      "variationNum": {
                                        "type": "integer",
                                        "description": "Number of variations",
                                        "example": 1
                                      },
                                      "variant30DayUnits": {
                                        "type": "integer",
                                        "description": "Variant monthly sales (units)",
                                        "example": 1
                                      },
                                      "variant30DayRevenue": {
                                        "type": "number",
                                        "description": "Variant monthly sales revenue",
                                        "example": 1
                                      },
                                      "variant30DayUpdatedAt": {
                                        "type": "string",
                                        "description": "Variant data update time (timestamp)",
                                        "example": "2026-01-01"
                                      },
                                      "amzUnitDateString": {
                                        "type": "string",
                                        "description": "Variant sales update date",
                                        "example": "2026-01-01"
                                      },
                                      "listingQualityScore": {
                                        "type": "number",
                                        "description": "Listing quality score",
                                        "example": 1
                                      },
                                      "nodeLabelPath": {
                                        "type": "string",
                                        "description": "Category path",
                                        "example": null
                                      },
                                      "nodeIdPath": {
                                        "type": "string",
                                        "description": "Node ID path",
                                        "example": null
                                      },
                                      "nodeId": {
                                        "type": "integer",
                                        "description": "Node ID",
                                        "example": 1
                                      },
                                      "dimension": {
                                        "type": "string",
                                        "description": "Product dimensions",
                                        "example": null
                                      },
                                      "dimensionsType": {
                                        "type": "string",
                                        "description": "Dimension type",
                                        "example": null
                                      },
                                      "weight": {
                                        "type": "string",
                                        "description": "Product weight",
                                        "example": null
                                      },
                                      "packageDimensions": {
                                        "type": "string",
                                        "description": "Package dimensions",
                                        "example": null
                                      },
                                      "packageDimensionType": {
                                        "type": "string",
                                        "description": "Package dimension type",
                                        "example": null
                                      },
                                      "packageWeight": {
                                        "type": "string",
                                        "description": "Package weight",
                                        "example": null
                                      },
                                      "sku": {
                                        "type": "string",
                                        "description": "SKU",
                                        "example": null
                                      },
                                      "keyword": {
                                        "type": "string",
                                        "description": "Matching keyword (if searched by keyword, displays the corresponding keyword)",
                                        "example": "phone case"
                                      },
                                      "dataSnapshotMonth": {
                                        "type": "string",
                                        "description": "Data query month",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source type",
                                        "example": null
                                      },
                                      "badgeBestSeller": {
                                        "type": "string",
                                        "description": "Best Seller badge (Y/N)",
                                        "example": null
                                      },
                                      "badgeAmazonChoice": {
                                        "type": "string",
                                        "description": "Amazon's Choice badge (Y/N)",
                                        "example": null
                                      },
                                      "badgeNewRelease": {
                                        "type": "string",
                                        "description": "New Release badge (Y/N)",
                                        "example": null
                                      },
                                      "badgeEbc": {
                                        "type": "string",
                                        "description": "A+ page (Y/N)",
                                        "example": null
                                      },
                                      "badgeVideo": {
                                        "type": "string",
                                        "description": "Video introduction (Y/N)",
                                        "example": null
                                      },
                                      "badge": {
                                        "type": "object",
                                        "description": "Badge detail object, containing: bestSeller, amazonChoice, newRelease, ebc, video (all Y/N strings)",
                                        "example": {}
                                      },
                                      "subcategories": {
                                        "type": "array",
                                        "description": "Subcategory rankings, each entry containing code (category code), rank (rank), label (name)",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "columns": [],
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "price": 1,
                        "primePrice": 1,
                        "averagePrice": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "monthlySalesUnitsGrowthRate": 1,
                        "bsr": 1,
                        "bsrGrowthRate": 1,
                        "bsrGrowthCount": 1,
                        "rating": 1,
                        "ratings": 1,
                        "ratingsGrowth": 1,
                        "ratingsRate": 1,
                        "brandUrl": "https://example.com/image.jpg",
                        "sellerId": "example-id",
                        "sellerNum": 1,
                        "availableDate": "2026-01-01",
                        "availableDateString": "2026-01-01",
                        "profit": 1,
                        "fba": 1,
                        "deliveryPrice": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "variationNum": 1,
                        "variant30DayUnits": 1,
                        "variant30DayRevenue": 1,
                        "variant30DayUpdatedAt": "2026-01-01",
                        "amzUnitDateString": "2026-01-01",
                        "listingQualityScore": 1,
                        "nodeId": 1,
                        "keyword": "phone case",
                        "badge": {},
                        "subcategories": []
                      }
                    ],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-competitor-lookup",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_competitor_lookup",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-keyword-expansion/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Keyword Expansion",
        "description": "Nexscope keyword expansion tool that expands a seed keyword into a list of related keywords with search volume, trends, PPC bids, ranking difficulty, and other metrics, covering 10 Amazon marketplaces including US, UK, DE, JP, etc. Trigger when the user mentions keyword expansion, keyword mining, long-tail keyword mining, related keywords, keyword suggestions, keyword discovery, PPC bid research, keyword competition, keyword discovery, Nexscope keywords, keyword expansion, keyword discovery, keyword scout, related keywords, long-tail keywords, keyword suggestions, PPC bid research, keyword competition, seed keyword expansion, keyword mining. Even if the user does not explicitly mention \"Nexscope\", if their need involves finding more related keywords and their search volume, competition, and other metrics starting from a seed keyword, this skill should also be triggered.",
        "operationId": "runAmazonKeywordExpansion",
        "externalDocs": {
          "description": "Amazon Keyword Expansion documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-keyword-expansion"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-keyword-expansion.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp. Default us",
                    "example": "us"
                  },
                  "searchTerms": {
                    "type": "string",
                    "description": "Seed keyword (single keyword string)",
                    "example": "phone case"
                  },
                  "needCount": {
                    "type": "integer",
                    "description": "Total number of results returned",
                    "example": 10
                  },
                  "sort": {
                    "type": "string",
                    "description": "Sort field, default -monthly_search_volume_exact (exact search volume descending)"
                  },
                  "minMonthlySearchVolumeExact": {
                    "type": "integer",
                    "description": "Minimum exact search volume",
                    "example": 1
                  },
                  "maxMonthlySearchVolumeExact": {
                    "type": "integer",
                    "description": "Maximum exact search volume",
                    "example": 1
                  },
                  "minMonthlySearchVolumeBroad": {
                    "type": "integer",
                    "description": "Minimum broad search volume",
                    "example": 1
                  },
                  "maxMonthlySearchVolumeBroad": {
                    "type": "integer",
                    "description": "Maximum broad search volume",
                    "example": 1
                  },
                  "minWordCount": {
                    "type": "integer",
                    "description": "Minimum word count for keywords (for filtering long-tail keywords)",
                    "example": 1
                  },
                  "maxWordCount": {
                    "type": "integer",
                    "description": "Maximum word count for keywords",
                    "example": 1
                  },
                  "minOrganicProductCount": {
                    "type": "integer",
                    "description": "Minimum organic product count",
                    "example": 1
                  },
                  "maxOrganicProductCount": {
                    "type": "integer",
                    "description": "Maximum organic product count",
                    "example": 1
                  }
                },
                "required": [
                  "marketplace",
                  "searchTerms"
                ],
                "example": {
                  "needCount": 10,
                  "searchTerms": "phone case",
                  "marketplace": "us"
                },
                "additionalProperties": true
              },
              "example": {
                "needCount": 10,
                "searchTerms": "phone case",
                "marketplace": "us"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "keywordInfoList": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Keyword information list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "name": {
                                        "type": "string",
                                        "description": "Keyword name",
                                        "example": null
                                      },
                                      "country": {
                                        "type": "string",
                                        "description": "Marketplace code",
                                        "example": null
                                      },
                                      "monthlySearchVolumeExact": {
                                        "type": "integer",
                                        "description": "Monthly average exact match search volume",
                                        "example": 1
                                      },
                                      "monthlySearchVolumeBroad": {
                                        "type": "integer",
                                        "description": "Monthly average broad match search volume",
                                        "example": 1
                                      },
                                      "monthlyTrend": {
                                        "type": "number",
                                        "description": "Monthly search volume change percentage",
                                        "example": 1
                                      },
                                      "quarterlyTrend": {
                                        "type": "number",
                                        "description": "Quarterly search volume change percentage",
                                        "example": 1
                                      },
                                      "dominantCategory": {
                                        "type": "string",
                                        "description": "Category with the highest share in search results",
                                        "example": null
                                      },
                                      "relevancyScore": {
                                        "type": "integer",
                                        "description": "Relative relevance score to the seed keyword. Higher values indicate a closer match; the upstream provider does not document a fixed 0-100 range",
                                        "example": 1
                                      },
                                      "easeOfRankingScore": {
                                        "type": "integer",
                                        "description": "Ease of ranking score (higher means easier to rank)",
                                        "example": 1
                                      },
                                      "organicProductCount": {
                                        "type": "integer",
                                        "description": "Number of organic ranking products",
                                        "example": 1
                                      },
                                      "sponsoredProductCount": {
                                        "type": "integer",
                                        "description": "Number of sponsored products",
                                        "example": 1
                                      },
                                      "ppcBidExact": {
                                        "type": "number",
                                        "description": "Exact match PPC suggested bid (USD)",
                                        "example": 1
                                      },
                                      "ppcBidBroad": {
                                        "type": "number",
                                        "description": "Broad match PPC suggested bid (USD)",
                                        "example": 1
                                      },
                                      "spBrandAdBid": {
                                        "type": "number",
                                        "description": "Sponsored Brand ad suggested bid (USD)",
                                        "example": 1
                                      },
                                      "recommendedPromotions": {
                                        "type": "integer",
                                        "description": "Number of recommended promotion giveaways",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "costToken": 1,
                    "keywordInfoList": [
                      {
                        "monthlySearchVolumeExact": 1,
                        "monthlySearchVolumeBroad": 1,
                        "monthlyTrend": 1,
                        "quarterlyTrend": 1,
                        "relevancyScore": 1,
                        "easeOfRankingScore": 1,
                        "organicProductCount": 1,
                        "sponsoredProductCount": 1,
                        "ppcBidExact": 1,
                        "ppcBidBroad": 1,
                        "spBrandAdBid": 1,
                        "recommendedPromotions": 1
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-keyword-expansion",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_keyword_expansion",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-keyword-intelligence/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Keyword Intelligence",
        "description": "Query and analyze Amazon ABA (Brand Analytics) search term data, covering 15 marketplaces with nearly 3 years of weekly data. Trigger when the user mentions ABA data, Amazon search term analysis, keyword mining, search ranking trends, market opportunity analysis, seasonal keywords, high-click low-conversion analysis, blue ocean keyword discovery, competitor keyword analysis, ABA data, search term report, keyword mining, search ranking trends, blue ocean keywords, click share, conversion share, seasonal keywords, market opportunity analysis, competitor keywords. Even if the user does not explicitly mention \"ABA\", if their need involves Amazon search term data and ranking analysis, this skill should also be triggered.",
        "operationId": "runAmazonKeywordIntelligence",
        "externalDocs": {
          "description": "Amazon Keyword Intelligence documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-keyword-intelligence"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-keyword-intelligence.",
                "properties": {
                  "analysisDescription": {
                    "type": "string",
                    "description": "Natural language description that precisely expresses the query intent",
                    "example": "Analyze Amazon Brand Analytics search demand for phone case in the US marketplace"
                  },
                  "region": {
                    "type": "string",
                    "description": "Site code, default US. Options: US, DE, BR, CA, AU, JP, AE, ES, FR, IT, SA, TR, MX, SE, NL",
                    "example": "US"
                  },
                  "createDownloadUrl": {
                    "type": "boolean",
                    "description": "Whether to generate a CSV download link, default false",
                    "example": false
                  }
                },
                "required": [
                  "analysisDescription"
                ],
                "example": {
                  "region": "US",
                  "createDownloadUrl": false,
                  "analysisDescription": "Find Amazon Brand Analytics search demand for phone case in the US marketplace"
                },
                "additionalProperties": true
              },
              "example": {
                "region": "US",
                "createDownloadUrl": false,
                "analysisDescription": "Find Amazon Brand Analytics search demand for phone case in the US marketplace"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "success": {
                              "anyOf": [
                                {
                                  "type": "boolean",
                                  "description": "Whether the query succeeded",
                                  "example": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "tables": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Result data array, each element containing data (data rows), columns (column definitions), name (Sheet name)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "data": {
                                        "type": "array",
                                        "description": "Query result rows; actual columns vary with the query",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "searchTerm": {
                                              "type": "string",
                                              "description": "Consumer search term",
                                              "example": null
                                            },
                                            "reportStartDate": {
                                              "type": "string",
                                              "description": "Start date of the reporting week",
                                              "example": null
                                            },
                                            "region": {
                                              "type": "string",
                                              "description": "Amazon marketplace code",
                                              "example": null
                                            },
                                            "searchFrequencyRank": {
                                              "type": "integer",
                                              "description": "Search frequency rank; lower values indicate higher popularity",
                                              "example": null
                                            },
                                            "clickedAsin": {
                                              "type": "string",
                                              "description": "ASIN of the clicked product",
                                              "example": null
                                            },
                                            "clickedItemName": {
                                              "type": "string",
                                              "description": "Name of the clicked product",
                                              "example": null
                                            },
                                            "clickShareRank": {
                                              "type": "integer",
                                              "description": "Click share rank of this ASIN for the search term",
                                              "example": null
                                            },
                                            "clickShare": {
                                              "type": "number",
                                              "description": "Click share for this ASIN, from 0 to 1",
                                              "example": null
                                            },
                                            "conversionShare": {
                                              "type": "number",
                                              "description": "Conversion share for this ASIN, from 0 to 1",
                                              "example": null
                                            }
                                          }
                                        }
                                      },
                                      "columns": {
                                        "type": "array",
                                        "description": "Result column definitions",
                                        "example": []
                                      },
                                      "name": {
                                        "type": "string",
                                        "description": "Sheet name",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total result count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "downloadUrl": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "When createDownloadUrl is true, returns the CSV file URL",
                                  "example": "https://example.com/image.jpg"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "downloadNote": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Download-related note",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Latency (ms)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "success": false,
                    "tables": [
                      {
                        "data": [],
                        "columns": []
                      }
                    ],
                    "total": 1,
                    "downloadUrl": "https://example.com/image.jpg",
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-keyword-intelligence",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_keyword_intelligence",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-keyword-overview/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Keyword Overview",
        "description": "Nexscope overview analysis of Amazon keyword market competition. Trigger when the user mentions keyword competition, supply-demand ratio, competitor count, keyword search volume estimation, market competitiveness assessment, keyword popularity ranking, ad competition analysis, number of products under a keyword, keyword competition, supply-demand ratio, competitor count, search popularity, market competition analysis, Nexscope, keyword overview. Even if the user does not explicitly say \"Nexscope\", if their need involves assessing keyword-level competition intensity, supply-demand balance, or search result product count on Amazon, this skill should also be triggered.",
        "operationId": "runAmazonKeywordOverview",
        "externalDocs": {
          "description": "Amazon Keyword Overview documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-keyword-overview"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-keyword-overview.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Keyword, translate to the corresponding country's language whenever possible. Max length: 1000 characters",
                    "example": "phone case"
                  },
                  "country": {
                    "type": "string",
                    "description": "Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA"
                  },
                  "last7d": {
                    "type": "boolean",
                    "description": "Whether to get last 7 days data, default true. When false, use startDate/endDate range",
                    "example": true
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Start date yyyy-MM-dd (effective when last7d=false)",
                    "example": "2026-01-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "End date yyyy-MM-dd (paired with startDate)",
                    "example": "2026-01-01"
                  }
                },
                "required": [
                  "keyword"
                ],
                "example": {
                  "last7d": true,
                  "keyword": "phone case",
                  "country": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "last7d": true,
                "keyword": "phone case",
                "country": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total data count. Note: this endpoint typically returns only a single record, total is usually 1",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Return data (see data fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "keyword": {
                                        "type": "string",
                                        "description": "Keyword. The keyword text of the search query",
                                        "example": "phone case"
                                      },
                                      "keywordPopularityRank": {
                                        "type": "integer",
                                        "description": "Keyword popularity rank. This keyword's monthly search volume ranking among all Amazon keywords; lower values indicate higher search volume",
                                        "example": 1
                                      },
                                      "estimatedWeeklySearchVolume": {
                                        "type": "integer",
                                        "description": "Estimated weekly search volume. Estimated weekly search count for this keyword on Amazon, reflecting its search popularity",
                                        "example": 1
                                      },
                                      "supplyDemandRatio": {
                                        "type": "number",
                                        "description": "Supply-demand ratio. Ratio of supply to demand, formula: search result product count / monthly search volume; lower values indicate less competition and greater opportunity",
                                        "example": 1
                                      },
                                      "totalSearchResultProductCount": {
                                        "type": "integer",
                                        "description": "Total search result product count. Total number of products displayed for this keyword (including natural search, ad placements, recommendation placements, etc.)",
                                        "example": 1
                                      },
                                      "naturalSearchProductCount": {
                                        "type": "integer",
                                        "description": "Natural search product count. Number of products displayed in natural search results for this keyword (excluding ad placements)",
                                        "example": 1
                                      },
                                      "sponsoredProductsCount": {
                                        "type": "integer",
                                        "description": "SP ad product count. Number of products running Sponsored Products ads for this keyword",
                                        "example": 1
                                      },
                                      "brandAdProductCount": {
                                        "type": "integer",
                                        "description": "Brand ad product count. Number of products running brand ads for this keyword",
                                        "example": 1
                                      },
                                      "videoAdProductCount": {
                                        "type": "integer",
                                        "description": "Video ad product count. Number of products running video ads for this keyword",
                                        "example": 1
                                      },
                                      "paidAdvertisingProductCount": {
                                        "type": "integer",
                                        "description": "Total PPC ad product count. Total number of products running any PPC paid ads for this keyword (including SP, brand ads, video ads, etc.)",
                                        "example": 1
                                      },
                                      "amazonChoiceProductCount": {
                                        "type": "integer",
                                        "description": "Amazon's Choice product count. Number of products with the Amazon's Choice badge for this keyword",
                                        "example": 1
                                      },
                                      "topRatedProductCount": {
                                        "type": "integer",
                                        "description": "Top Rated recommended product count. Number of products appearing in the Top Rated (high rating) recommendation placement for this keyword",
                                        "example": 1
                                      },
                                      "searchRecommendationProductCount": {
                                        "type": "integer",
                                        "description": "Search recommendation product count. Number of products recommended by Amazon when searching this keyword",
                                        "example": 1
                                      },
                                      "editorialRecommendationsProductCount": {
                                        "type": "integer",
                                        "description": "Editorial Recommendations product count. Number of products appearing in the editorial recommendation placement for this keyword",
                                        "example": 1
                                      },
                                      "recNonadProductCount": {
                                        "type": "integer",
                                        "description": "Recommendation placement non-ad product count. Number of non-ad (organic) products in recommendation placements for this keyword",
                                        "example": 1
                                      },
                                      "recAdProductCount": {
                                        "type": "integer",
                                        "description": "Recommendation placement ad product count. Number of ad products in recommendation placements for this keyword",
                                        "example": 1
                                      },
                                      "trackedAsinTotalCount": {
                                        "type": "integer",
                                        "description": "Nexscope tracked ASIN deduplicated total count. Deduplicated count of ASINs that Nexscope has tracked with exposure scores across all positions (natural/ad/recommendation) for this keyword (upstream field: totalAsinNum)",
                                        "example": 1
                                      },
                                      "totalMarketplaceKeywordCount": {
                                        "type": "integer",
                                        "description": "Total marketplace keyword count. Total number of keywords for this site, used to understand overall market size",
                                        "example": 1
                                      },
                                      "dataPeriodStartDate": {
                                        "type": "string",
                                        "description": "Data period start date. ABA week start date corresponding to the returned data (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "dataPeriodEndDate": {
                                        "type": "string",
                                        "description": "Data period end date. ABA week end date corresponding to the returned data (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "keywordDataUpdateTime": {
                                        "type": "string",
                                        "description": "Keyword data update time",
                                        "example": "phone case"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Latency (ms)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "keyword": "phone case",
                        "keywordPopularityRank": 1,
                        "estimatedWeeklySearchVolume": 1,
                        "supplyDemandRatio": 1,
                        "totalSearchResultProductCount": 1,
                        "naturalSearchProductCount": 1,
                        "sponsoredProductsCount": 1,
                        "brandAdProductCount": 1,
                        "videoAdProductCount": 1,
                        "paidAdvertisingProductCount": 1,
                        "amazonChoiceProductCount": 1,
                        "topRatedProductCount": 1,
                        "searchRecommendationProductCount": 1,
                        "editorialRecommendationsProductCount": 1,
                        "recNonadProductCount": 1,
                        "recAdProductCount": 1,
                        "trackedAsinTotalCount": 1,
                        "totalMarketplaceKeywordCount": 1,
                        "dataPeriodStartDate": "2026-01-01",
                        "dataPeriodEndDate": "2026-01-01",
                        "keywordDataUpdateTime": "phone case"
                      }
                    ],
                    "costTime": 1,
                    "costToken": 1,
                    "columns": []
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-keyword-overview",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_keyword_overview",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-keyword-search-history/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Keyword Search History",
        "description": "Nexscope keyword historical search volume query, returning Amazon keyword exact search volume trends in 7-day periods, covering 10 marketplaces including US, UK, DE, JP, etc. Trigger when the user mentions keyword search volume trends, historical search volume, search popularity changes, keyword seasonality, search volume fluctuations, Nexscope search volume, keyword search volume history, keyword trend, search volume over time, seasonal search volume, keyword popularity trend. Even if the user does not explicitly mention \"Nexscope\", if their need involves viewing the search volume trend of an Amazon keyword over time, this skill should also be triggered.",
        "operationId": "runAmazonKeywordSearchHistory",
        "externalDocs": {
          "description": "Amazon Keyword Search History documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-keyword-search-history"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-keyword-search-history.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp",
                    "example": "us"
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Keyword to query",
                    "example": "phone case"
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Start date (format: YYYY-MM-DD)",
                    "example": "2026-01-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "End date (format: YYYY-MM-DD); max interval from startDate is 366 days",
                    "example": "2026-01-01"
                  }
                },
                "required": [
                  "marketplace",
                  "keyword",
                  "startDate",
                  "endDate"
                ],
                "example": {
                  "marketplace": "us",
                  "endDate": "2025-03-31",
                  "keyword": "phone case",
                  "startDate": "2026-01-01"
                },
                "additionalProperties": true
              },
              "example": {
                "marketplace": "us",
                "endDate": "2026-01-31",
                "keyword": "phone case",
                "startDate": "2026-01-01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "historicalSearchVolumeList": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Historical search volume period list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "description": "Data period identifier (market/keyword/date range)",
                                        "example": "example-id"
                                      },
                                      "estimateStartDate": {
                                        "type": "string",
                                        "description": "Period start date (YYYY-MM-DD, 7-day statistical period start)",
                                        "example": "2026-01-01"
                                      },
                                      "estimateEndDate": {
                                        "type": "string",
                                        "description": "Period end date (YYYY-MM-DD, 7-day statistical period end)",
                                        "example": "2026-01-01"
                                      },
                                      "estimatedExactSearchVolume": {
                                        "type": "integer",
                                        "description": "Exact match search volume for this period (searches/week)",
                                        "example": 1
                                      },
                                      "type": {
                                        "type": "string",
                                        "description": "Resource type, fixed value historical_keyword_search_volume",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "costToken": 1,
                    "historicalSearchVolumeList": [
                      {
                        "id": "example-id",
                        "estimateStartDate": "2026-01-01",
                        "estimateEndDate": "2026-01-01",
                        "estimatedExactSearchVolume": 1
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-keyword-search-history",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_keyword_search_history",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-keyword-share-of-voice/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Keyword Share Of Voice",
        "description": "Nexscope keyword Share of Voice analysis, returning brand visibility share across the first 3 pages of Amazon search results (organic/ad/combined), 30-day exact search volume, median PPC bid, and TOP3 ASIN click and conversion data, covering 10 marketplaces. Trigger when the user mentions brand market share, brand voice share, search result brand distribution, Share of Voice, SOV analysis, brand competitive landscape, ad slot share, organic ranking brand share, PPC bid analysis, brand monopoly analysis, keyword share of voice, brand visibility, organic vs sponsored share, brand dominance, PPC bid analysis, search result brand distribution, competitive landscape, weighted SOV, top ASIN clicks conversions. Even if the user does not explicitly mention \"Share of Voice\" or \"SOV\", if their need involves analyzing brand market share or competitive landscape in Amazon keyword search results, this skill should also be triggered.",
        "operationId": "runAmazonKeywordShareOfVoice",
        "externalDocs": {
          "description": "Amazon Keyword Share Of Voice documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-keyword-share-of-voice"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-keyword-share-of-voice.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp",
                    "example": "us"
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Keyword to query",
                    "example": "phone case"
                  }
                },
                "required": [
                  "marketplace",
                  "keyword"
                ],
                "example": {
                  "marketplace": "us",
                  "keyword": "phone case"
                },
                "additionalProperties": true
              },
              "example": {
                "marketplace": "us",
                "keyword": "phone case"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "shareOfVoice": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "description": "Share of Voice data body",
                                  "example": {},
                                  "properties": {
                                    "id": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "Resource identifier",
                                          "example": "example-id"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "type": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "Fixed value share_of_voice",
                                          "example": null
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "estimated30DaySearchVolume": {
                                      "anyOf": [
                                        {
                                          "type": "integer",
                                          "description": "Exact match search volume over the past 30 days",
                                          "example": 1
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "exactSuggestedBidMedian": {
                                      "anyOf": [
                                        {
                                          "type": "number",
                                          "description": "PPC bid median (USD)",
                                          "example": 1
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "productCount": {
                                      "anyOf": [
                                        {
                                          "type": "integer",
                                          "description": "Total product count in the first 3 pages of search results",
                                          "example": 1
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "updatedAt": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "Data update time",
                                          "example": "2026-01-01"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "topAsinsModelStartDate": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "TOP ASIN click/conversion data window start date",
                                          "example": "B072MQ5BRX"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "topAsinsModelEndDate": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "TOP ASIN click/conversion data window end date",
                                          "example": "B072MQ5BRX"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "brands": {
                                      "anyOf": [
                                        {
                                          "type": "array",
                                          "description": "Brand SOV detail list",
                                          "example": [],
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "brand": {
                                                "type": "string",
                                                "description": "Brand name",
                                                "example": null
                                              },
                                              "organicProducts": {
                                                "type": "integer",
                                                "description": "Number of products in organic search results",
                                                "example": 1
                                              },
                                              "sponsoredProducts": {
                                                "type": "integer",
                                                "description": "Number of products in ad placements",
                                                "example": 1
                                              },
                                              "combinedProducts": {
                                                "type": "integer",
                                                "description": "Combined product count",
                                                "example": 1
                                              },
                                              "organicBasicSov": {
                                                "type": "number",
                                                "description": "Organic basic SOV (0-1)",
                                                "example": 1
                                              },
                                              "organicWeightedSov": {
                                                "type": "number",
                                                "description": "Organic weighted SOV (0-1)",
                                                "example": 1
                                              },
                                              "sponsoredBasicSov": {
                                                "type": "number",
                                                "description": "Sponsored basic SOV (0-1)",
                                                "example": 1
                                              },
                                              "sponsoredWeightedSov": {
                                                "type": "number",
                                                "description": "Sponsored weighted SOV (0-1)",
                                                "example": 1
                                              },
                                              "combinedBasicSov": {
                                                "type": "number",
                                                "description": "Combined basic SOV (0-1)",
                                                "example": 1
                                              },
                                              "combinedWeightedSov": {
                                                "type": "number",
                                                "description": "Combined weighted SOV (0-1)",
                                                "example": 1
                                              },
                                              "organicAveragePosition": {
                                                "type": "number",
                                                "description": "Average organic search rank position",
                                                "example": 1
                                              },
                                              "sponsoredAveragePosition": {
                                                "type": "number",
                                                "description": "Average sponsored search rank position",
                                                "example": 1
                                              },
                                              "combinedAveragePosition": {
                                                "type": "number",
                                                "description": "Combined average rank position",
                                                "example": 1
                                              },
                                              "organicAveragePrice": {
                                                "type": "number",
                                                "description": "Average organic search product price",
                                                "example": 1
                                              },
                                              "sponsoredAveragePrice": {
                                                "type": "number",
                                                "description": "Average sponsored search product price",
                                                "example": 1
                                              },
                                              "combinedAveragePrice": {
                                                "type": "number",
                                                "description": "Combined average product price",
                                                "example": 1
                                              }
                                            }
                                          }
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "topAsins": {
                                      "anyOf": [
                                        {
                                          "type": "array",
                                          "description": "TOP 3 ASIN click and conversion list",
                                          "example": [],
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "asin": {
                                                "type": "string",
                                                "description": "ASIN number",
                                                "example": "B072MQ5BRX"
                                              },
                                              "name": {
                                                "type": "string",
                                                "description": "Product name",
                                                "example": null
                                              },
                                              "brand": {
                                                "type": "string",
                                                "description": "Brand name",
                                                "example": null
                                              },
                                              "clicks": {
                                                "type": "integer",
                                                "description": "Click volume (30-day window)",
                                                "example": 1
                                              },
                                              "conversions": {
                                                "type": "integer",
                                                "description": "Conversion volume (30-day window)",
                                                "example": 1
                                              },
                                              "conversionRate": {
                                                "type": "number",
                                                "description": "Conversion rate (0-1)",
                                                "example": 1
                                              }
                                            }
                                          }
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "costToken": 1,
                    "shareOfVoice": {
                      "id": "example-id",
                      "estimated30DaySearchVolume": 1,
                      "exactSuggestedBidMedian": 1,
                      "productCount": 1,
                      "updatedAt": "2026-01-01",
                      "topAsinsModelStartDate": "B072MQ5BRX",
                      "topAsinsModelEndDate": "B072MQ5BRX",
                      "brands": [
                        {
                          "organicProducts": 1,
                          "sponsoredProducts": 1,
                          "combinedProducts": 1,
                          "organicBasicSov": 1,
                          "organicWeightedSov": 1,
                          "sponsoredBasicSov": 1,
                          "sponsoredWeightedSov": 1,
                          "combinedBasicSov": 1,
                          "combinedWeightedSov": 1,
                          "organicAveragePosition": 1,
                          "sponsoredAveragePosition": 1,
                          "combinedAveragePosition": 1,
                          "organicAveragePrice": 1,
                          "sponsoredAveragePrice": 1,
                          "combinedAveragePrice": 1
                        }
                      ],
                      "topAsins": [
                        {
                          "asin": "B072MQ5BRX",
                          "clicks": 1,
                          "conversions": 1,
                          "conversionRate": 1
                        }
                      ]
                    }
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-keyword-share-of-voice",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_keyword_share_of_voice",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-keyword-summary/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Keyword Summary",
        "description": "Break down all competitor ASIN traffic sources under a given keyword -- organic search, SP ads, SB brand ads, SBV video ads, SP recommendations, AC/ER/TR recommendation slots, with support for ASIN filtering, custom date ranges, and new traffic keyword filters. Trigger when the user mentions keyword traffic sources, which competitors are grabbing traffic under this keyword, organic traffic vs paid traffic share, SP ad exposure, brand ad share, SP recommendation slots, recommendation ad/non-ad split, search display analysis, Amazon's Choice or editorial recommendation exposure, keyword competitive landscape, ASIN traffic composition, keyword traffic, traffic structure analysis, search share, ad share, traffic source distribution, Nexscope, traffic analysis, SP recommendation, recommend position breakdown. Even if the user does not explicitly mention \"Nexscope\", if their need involves analyzing competitor ASIN traffic source distribution under a keyword, this skill should also be triggered.",
        "operationId": "runAmazonKeywordSummary",
        "externalDocs": {
          "description": "Amazon Keyword Summary documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-keyword-summary"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-keyword-summary.",
                "properties": {
                  "searchKeyword": {
                    "type": "string",
                    "description": "Search keyword, translate to the corresponding country's language whenever possible. Max length 1000 characters",
                    "example": "phone case"
                  },
                  "country": {
                    "type": "string",
                    "description": "Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA"
                  },
                  "asins": {
                    "type": "string",
                    "description": "ASIN filter list, comma-separated; if not provided, returns all ASINs for this keyword. Max length 1000 characters",
                    "example": "B072MQ5BRX"
                  },
                  "condition": {
                    "type": "string",
                    "description": "Condition filter, only one at a time.<br>Flag type: nfPosition (natural traffic keyword), isSpAd (SP ad keyword), isVedioAd (video ad keyword), isBrandAd (brand ad keyword), isPPCAd (PPC ad keyword), isSearchRecommend (search recommendation keyword), acAd (SP recommendation)<br>Period count type: totalPeriod.in (new incoming traffic keywords), nfKeywordCnt.total / .in, adKeywordCnt.total / .in, allSpKeywordCnt.total / .in, spKeywordCnt.total / .in, recSpKeywordCnt.total / .in, allSbKeywordCnt.total / .in, sbKeywordCnt.total / .in, sbvKeywordCnt.total / .in"
                  },
                  "last7d": {
                    "type": "boolean",
                    "description": "Whether to get last 7 days data, default true. When false, use startDate/endDate range",
                    "example": true
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system full week is used)",
                    "example": "2026-01-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "End date yyyy-MM-dd (paired with startDate)",
                    "example": "2026-01-01"
                  },
                  "sortBy": {
                    "type": "string",
                    "description": "Sort field. Options: totalKeywordNum (all traffic keywords), naturalKeywordNum (natural traffic keywords), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC recommended keywords), erKeywordNum (ER recommended keywords), trKeywordNum (TR recommended keywords), sumScore (total keyword exposure score), totalNfScore, totalSpSocre (note spelling), totalBrandScore, totalVedioScore, totalAcScore, totalTrScore, totalErScore"
                  },
                  "pageNum": {
                    "type": "integer",
                    "description": "Page number, default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page, min 10, max 100, default 100",
                    "example": 10
                  },
                  "desc": {
                    "type": "boolean",
                    "description": "Whether to sort descending, default true",
                    "example": true
                  }
                },
                "required": [
                  "searchKeyword"
                ],
                "example": {
                  "searchKeyword": "phone case",
                  "pageSize": 10,
                  "last7d": true,
                  "pageNum": 1,
                  "country": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "searchKeyword": "phone case",
                "pageSize": 10,
                "last7d": true,
                "pageNum": 1,
                "country": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of data records actually returned",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Return data, array of product keyword traffic data objects",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "ASIN code",
                                        "example": "B072MQ5BRX"
                                      },
                                      "productTitle": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "productImageUrl": {
                                        "type": "string",
                                        "description": "Product main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPrice": {
                                        "type": "number",
                                        "description": "Product price",
                                        "example": 1
                                      },
                                      "customerRatingCount": {
                                        "type": "integer",
                                        "description": "Total customer rating count",
                                        "example": 1
                                      },
                                      "productStarRating": {
                                        "type": "number",
                                        "description": "Product star rating (0-5 stars)",
                                        "example": 1
                                      },
                                      "productRatingScore": {
                                        "type": "number",
                                        "description": "Product rating score value",
                                        "example": 1
                                      },
                                      "productUpdateTime": {
                                        "type": "string",
                                        "description": "Product update time (yyyy-MM-dd HH:mm:ss)",
                                        "example": "2026-01-01"
                                      },
                                      "dataPeriodStartDate": {
                                        "type": "string",
                                        "description": "Data period start date (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "totalExposureScore": {
                                        "type": "number",
                                        "description": "Total exposure score",
                                        "example": 1
                                      },
                                      "totalExposureRatio": {
                                        "type": "number",
                                        "description": "Total traffic share",
                                        "example": 1
                                      },
                                      "naturalSearchExposureScore": {
                                        "type": "number",
                                        "description": "Natural search exposure total score",
                                        "example": 1
                                      },
                                      "naturalSearchExposureRatio": {
                                        "type": "number",
                                        "description": "Natural search exposure ratio",
                                        "example": 1
                                      },
                                      "sponsoredProductsExposureScore": {
                                        "type": "number",
                                        "description": "SP ad exposure total score",
                                        "example": 1
                                      },
                                      "sponsoredProductsExposureRatio": {
                                        "type": "number",
                                        "description": "SP ad exposure ratio",
                                        "example": 1
                                      },
                                      "brandAdExposureScore": {
                                        "type": "number",
                                        "description": "Brand ad exposure total score",
                                        "example": 1
                                      },
                                      "brandAdExposureRatio": {
                                        "type": "number",
                                        "description": "Brand ad exposure ratio",
                                        "example": 1
                                      },
                                      "videoAdExposureScore": {
                                        "type": "number",
                                        "description": "Video ad exposure total score",
                                        "example": 1
                                      },
                                      "videoAdExposureRatio": {
                                        "type": "number",
                                        "description": "Video ad exposure ratio",
                                        "example": 1
                                      },
                                      "amazonsChoiceExposureScore": {
                                        "type": "number",
                                        "description": "AC exposure total score",
                                        "example": 1
                                      },
                                      "amazonsChoiceExposureRatio": {
                                        "type": "number",
                                        "description": "AC exposure ratio",
                                        "example": 1
                                      },
                                      "editorialRecommendationsExposureScore": {
                                        "type": "number",
                                        "description": "ER exposure total score",
                                        "example": 1
                                      },
                                      "editorialRecommendationsExposureRatio": {
                                        "type": "number",
                                        "description": "ER exposure ratio",
                                        "example": 1
                                      },
                                      "topRatedExposureScore": {
                                        "type": "number",
                                        "description": "TR exposure total score",
                                        "example": 1
                                      },
                                      "topRatedExposureRatio": {
                                        "type": "number",
                                        "description": "TR exposure ratio",
                                        "example": 1
                                      },
                                      "recommendPositionExposureScore": {
                                        "type": "number",
                                        "description": "Recommendation position exposure total score",
                                        "example": 1
                                      },
                                      "recommendAdExposureScore": {
                                        "type": "number",
                                        "description": "Recommendation position ad exposure score",
                                        "example": 1
                                      },
                                      "recommendAdExposureRatio": {
                                        "type": "number",
                                        "description": "Recommendation position ad traffic share",
                                        "example": 1
                                      },
                                      "recommendNonadExposureScore": {
                                        "type": "number",
                                        "description": "Recommendation position non-ad exposure score",
                                        "example": 1
                                      },
                                      "recommendNonadExposureRatio": {
                                        "type": "number",
                                        "description": "Recommendation position non-ad traffic share",
                                        "example": 1
                                      },
                                      "comprehensiveNaturalExposureScore": {
                                        "type": "number",
                                        "description": "Comprehensive natural traffic score (natural search + recommendation non-ad)",
                                        "example": 1
                                      },
                                      "comprehensiveNaturalExposureRatio": {
                                        "type": "number",
                                        "description": "Comprehensive natural traffic share",
                                        "example": 1
                                      },
                                      "keywordTotalExposureScore": {
                                        "type": "number",
                                        "description": "Keyword total score",
                                        "example": 1
                                      },
                                      "keywordNaturalExposureScore": {
                                        "type": "number",
                                        "description": "Keyword natural score",
                                        "example": 1
                                      },
                                      "keywordSponsoredProductsExposureScore": {
                                        "type": "number",
                                        "description": "Keyword SP ad score",
                                        "example": 1
                                      },
                                      "keywordBrandAdExposureScore": {
                                        "type": "number",
                                        "description": "Keyword brand ad score",
                                        "example": 1
                                      },
                                      "keywordVideoAdExposureScore": {
                                        "type": "number",
                                        "description": "Keyword video ad score",
                                        "example": 1
                                      },
                                      "keywordAmazonsChoiceExposureScore": {
                                        "type": "number",
                                        "description": "Keyword AC score",
                                        "example": 1
                                      },
                                      "keywordRecommendExposureScore": {
                                        "type": "number",
                                        "description": "Keyword recommendation position score",
                                        "example": 1
                                      },
                                      "keywordRecommendAdExposureScore": {
                                        "type": "number",
                                        "description": "Keyword recommendation position ad score",
                                        "example": 1
                                      },
                                      "keywordRecommendNonadExposureScore": {
                                        "type": "number",
                                        "description": "Keyword recommendation position non-ad score",
                                        "example": 1
                                      },
                                      "keywordComprehensiveNaturalExposureScore": {
                                        "type": "number",
                                        "description": "Keyword comprehensive natural score (natural + recommendation non-ad)",
                                        "example": 1
                                      },
                                      "ppcTrafficSources": {
                                        "type": "array",
                                        "description": "PPC paid ad traffic source markers. Contains: SP ads, top brand ads, bottom brand ads, video ads",
                                        "example": []
                                      },
                                      "naturalSearchTrafficSources": {
                                        "type": "array",
                                        "description": "Natural search traffic source markers",
                                        "example": []
                                      },
                                      "amazonRecommendationSources": {
                                        "type": "array",
                                        "description": "Amazon recommendation traffic source markers. Contains: Best Seller, AC, ER, TR, TRFOB, etc.",
                                        "example": []
                                      },
                                      "promotionalDealSources": {
                                        "type": "array",
                                        "description": "Promotional deal traffic source markers. Contains: Coupon, Limited Time Deal, Lowest Price in 30 Days, etc.",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Latency (ms)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "asin": "B072MQ5BRX",
                        "productImageUrl": "https://example.com/image.jpg",
                        "productPrice": 1,
                        "customerRatingCount": 1,
                        "productStarRating": 1,
                        "productRatingScore": 1,
                        "productUpdateTime": "2026-01-01",
                        "dataPeriodStartDate": "2026-01-01",
                        "totalExposureScore": 1,
                        "totalExposureRatio": 1,
                        "naturalSearchExposureScore": 1,
                        "naturalSearchExposureRatio": 1,
                        "sponsoredProductsExposureScore": 1,
                        "sponsoredProductsExposureRatio": 1,
                        "brandAdExposureScore": 1,
                        "brandAdExposureRatio": 1,
                        "videoAdExposureScore": 1,
                        "videoAdExposureRatio": 1,
                        "amazonsChoiceExposureScore": 1,
                        "amazonsChoiceExposureRatio": 1,
                        "editorialRecommendationsExposureScore": 1,
                        "editorialRecommendationsExposureRatio": 1,
                        "topRatedExposureScore": 1,
                        "topRatedExposureRatio": 1,
                        "recommendPositionExposureScore": 1,
                        "recommendAdExposureScore": 1,
                        "recommendAdExposureRatio": 1,
                        "recommendNonadExposureScore": 1,
                        "recommendNonadExposureRatio": 1,
                        "comprehensiveNaturalExposureScore": 1,
                        "comprehensiveNaturalExposureRatio": 1,
                        "keywordTotalExposureScore": 1,
                        "keywordNaturalExposureScore": 1,
                        "keywordSponsoredProductsExposureScore": 1,
                        "keywordBrandAdExposureScore": 1,
                        "keywordVideoAdExposureScore": 1,
                        "keywordAmazonsChoiceExposureScore": 1,
                        "keywordRecommendExposureScore": 1,
                        "keywordRecommendAdExposureScore": 1,
                        "keywordRecommendNonadExposureScore": 1,
                        "keywordComprehensiveNaturalExposureScore": 1,
                        "ppcTrafficSources": [],
                        "naturalSearchTrafficSources": [],
                        "amazonRecommendationSources": [],
                        "promotionalDealSources": []
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-keyword-summary",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_keyword_summary",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-market-product-detail/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Market Product Detail",
        "description": "Query Amazon product detail and historical trends by ASIN using Nexscope data, covering 14 marketplaces. Trigger when the user mentions Nexscope product detail, ASIN detail query, sales trends, price curves, price history, BSR ranking history, BSR trends, profit analysis, FBA fee analysis, gross margin, product trend analysis, daily/monthly sales, revenue trends, Deal promotion history, product detail, sales trend, price history, BSR ranking, profit analysis, FBA fees. Even if the user does not explicitly mention \"Nexscope\", if their need involves querying Amazon product detail or historical trend data by ASIN, this skill should also be triggered.",
        "operationId": "runAmazonMarketProductDetail",
        "externalDocs": {
          "description": "Amazon Market Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-market-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-market-product-detail.",
                "properties": {
                  "asin": {
                    "type": "string",
                    "description": "Amazon Standard Identification Number (ASIN), supports multiple (max 10), comma-separated. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ",
                    "example": "B072MQ5BRX"
                  },
                  "marketplace": {
                    "type": "string",
                    "description": "Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa",
                    "example": "us"
                  },
                  "includeTrend": {
                    "type": "integer",
                    "description": "Whether to include trend data. 1: include (default); 2: exclude",
                    "example": 1
                  },
                  "queryTrendStartDate": {
                    "type": "string",
                    "description": "Trend start date, format yyyy-MM-dd. Default returns only the last 15 days; querying more than 15 days doubles the cost",
                    "example": "2026-01-01"
                  },
                  "queryTrendEndDate": {
                    "type": "string",
                    "description": "Trend end date, format yyyy-MM-dd",
                    "example": "2026-01-15"
                  }
                },
                "required": [
                  "asin",
                  "marketplace"
                ],
                "example": {
                  "queryTrendEndDate": "2026-01-15",
                  "marketplace": "us",
                  "asin": "B072MQ5BRX",
                  "includeTrend": 1,
                  "queryTrendStartDate": "2026-01-01"
                },
                "additionalProperties": true
              },
              "example": {
                "queryTrendEndDate": "2026-01-15",
                "marketplace": "us",
                "asin": "B072MQ5BRX",
                "includeTrend": 1,
                "queryTrendStartDate": "2026-01-01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total result count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Latency (ms)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "requestConsumed": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Requests consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: Nexscope",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product detail list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Product link, Amazon Listing detail page URL",
                                        "example": "B072MQ5BRX"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Main image list (all product image URLs)",
                                        "example": []
                                      },
                                      "ebcPhoto": {
                                        "type": "array",
                                        "description": "A+ image list",
                                        "example": []
                                      },
                                      "storeName": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "description": {
                                        "type": "string",
                                        "description": "Five bullet points",
                                        "example": null
                                      },
                                      "productBadge": {
                                        "type": "array",
                                        "description": "Product badges, e.g. Amazon Choice, Best Seller, New Release, etc.",
                                        "example": []
                                      },
                                      "lastUpdate": {
                                        "type": "string",
                                        "description": "Update time, most recent ASIN data collection time (format yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "offSale": {
                                        "type": "boolean",
                                        "description": "Whether delisted. true = unavailable, false = available",
                                        "example": false
                                      },
                                      "productType": {
                                        "type": "string",
                                        "description": "Category, Amazon product category node name",
                                        "example": null
                                      },
                                      "weight": {
                                        "type": "string",
                                        "description": "Weight, unit g",
                                        "example": null
                                      },
                                      "size": {
                                        "type": "array",
                                        "description": "Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm",
                                        "example": []
                                      },
                                      "parentAsin": {
                                        "type": "string",
                                        "description": "Parent ASIN, the parent ASIN if variants exist, null if no variants",
                                        "example": "B072MQ5BRX"
                                      },
                                      "variationNum": {
                                        "type": "integer",
                                        "description": "Number of variations",
                                        "example": 1
                                      },
                                      "variationASIN": {
                                        "type": "array",
                                        "description": "Child ASIN list, empty if no variants",
                                        "example": []
                                      },
                                      "attribute": {
                                        "type": "array",
                                        "description": "Product attributes, variant attributes if variants exist. Each entry contains asin (child ASIN), name (attribute name), value (attribute value)",
                                        "example": []
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Selling price, actual price after coupon deduction, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "coupon": {
                                        "type": "integer",
                                        "description": "Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount)",
                                        "example": 1
                                      },
                                      "platformFee": {
                                        "type": "number",
                                        "description": "Platform commission, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "fbaFees": {
                                        "type": "number",
                                        "description": "FBA fees, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "fbaDetail": {
                                        "type": "array",
                                        "description": "FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,\"1-9:5\",\"10-12:15\"]",
                                        "example": []
                                      },
                                      "shipCost": {
                                        "type": "number",
                                        "description": "FBM shipping cost, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "shipsFrom": {
                                        "type": "string",
                                        "description": "Ship-from location",
                                        "example": null
                                      },
                                      "profitAmount": {
                                        "type": "number",
                                        "description": "Profit, final price - FBA fee - commission, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "profitRate": {
                                        "type": "number",
                                        "description": "Profit margin, e.g. 25.83 means 25.83%",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Official monthly sales volume, Amazon published ASIN monthly sales, latest value from the last 7 calendar days, 0 if unavailable",
                                        "example": 1
                                      },
                                      "salesRank": {
                                        "type": "integer",
                                        "description": "BSR rank, main category rank",
                                        "example": 1
                                      },
                                      "category": {
                                        "type": "array",
                                        "description": "Main category, [category name, NodeId]",
                                        "example": []
                                      },
                                      "bsrCategory": {
                                        "type": "array",
                                        "description": "Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd)",
                                        "example": []
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time, format yyyy-MM-dd",
                                        "example": "2026-01-01"
                                      },
                                      "onlineDays": {
                                        "type": "integer",
                                        "description": "Days since listing",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Current rating (0.0-5.0, e.g. 4.70)",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Number of ratings",
                                        "example": 1
                                      },
                                      "fiveStarRatings": {
                                        "type": "number",
                                        "description": "5-star percentage, e.g. 57.7 means 57.7%",
                                        "example": 1
                                      },
                                      "fourStarRatings": {
                                        "type": "number",
                                        "description": "4-star percentage",
                                        "example": 1
                                      },
                                      "threeStarRatings": {
                                        "type": "number",
                                        "description": "3-star percentage",
                                        "example": 1
                                      },
                                      "twoStarRatings": {
                                        "type": "number",
                                        "description": "2-star percentage",
                                        "example": 1
                                      },
                                      "oneStarRatings": {
                                        "type": "number",
                                        "description": "1-star percentage",
                                        "example": 1
                                      },
                                      "buyboxSeller": {
                                        "type": "string",
                                        "description": "Buybox seller name",
                                        "example": null
                                      },
                                      "buyBoxSellerId": {
                                        "type": "string",
                                        "description": "Buybox seller ID",
                                        "example": "example-id"
                                      },
                                      "buyboxSellerAddress": {
                                        "type": "string",
                                        "description": "Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own",
                                        "example": null
                                      },
                                      "isFBA": {
                                        "type": "boolean",
                                        "description": "Whether FBA, whether Buybox seller uses FBA logistics",
                                        "example": false
                                      },
                                      "sellerNum": {
                                        "type": "integer",
                                        "description": "Number of sellers",
                                        "example": 1
                                      },
                                      "aPlus": {
                                        "type": "boolean",
                                        "description": "Has A+",
                                        "example": false
                                      },
                                      "hasVideo": {
                                        "type": "boolean",
                                        "description": "Has video",
                                        "example": false
                                      },
                                      "hasBrandStore": {
                                        "type": "boolean",
                                        "description": "Has brand store",
                                        "example": false
                                      },
                                      "feature": {
                                        "type": "object",
                                        "description": "Product feature ratings, features and star ratings collected by Amazon for this product, e.g. {\"Battery life\":4.0}",
                                        "example": {}
                                      },
                                      "productInfo": {
                                        "type": "object",
                                        "description": "Product information, structured data from the Product Information section in the Listing",
                                        "example": {}
                                      },
                                      "property": {
                                        "type": "object",
                                        "description": "Attribute list, including variant attributes and Bullet Points header descriptions",
                                        "example": {}
                                      },
                                      "brandPromotion": {
                                        "type": "string",
                                        "description": "Brand promotion",
                                        "example": null
                                      },
                                      "dealType": {
                                        "type": "string",
                                        "description": "Deal label",
                                        "example": null
                                      },
                                      "extraSavings": {
                                        "type": "array",
                                        "description": "Associated promotions, e.g. [{Asin:xxx, Text:\"Save 5%...\"}]",
                                        "example": []
                                      },
                                      "rankTrend": {
                                        "type": "array",
                                        "description": "BSR trend, main category rank change history, interleaved format [date, rank, ...]",
                                        "example": []
                                      },
                                      "bsrRankTrend": {
                                        "type": "array",
                                        "description": "Subcategory rank trend, JSON format [{NodeId:xxx, Rank:[date, rank, ...]}]",
                                        "example": []
                                      },
                                      "listingSalesVolumeOfDailyTrend": {
                                        "type": "array",
                                        "description": "Daily sales volume trend, value -1 means unable to estimate",
                                        "example": []
                                      },
                                      "listingSalesOfDailyTrend": {
                                        "type": "array",
                                        "description": "Daily sales revenue trend, in local currency smallest unit (e.g. cents), value -1 means unable to estimate",
                                        "example": []
                                      },
                                      "listingSalesVolumeOfMonthTrend": {
                                        "type": "array",
                                        "description": "Monthly sales volume trend (last 30 days), value -1 means unable to estimate",
                                        "example": []
                                      },
                                      "listingSalesOfMonthTrend": {
                                        "type": "array",
                                        "description": "Monthly sales revenue trend, in local currency smallest unit (e.g. cents)",
                                        "example": []
                                      },
                                      "priceTrend": {
                                        "type": "array",
                                        "description": "Selling price trend, before coupon, in local currency smallest unit, -1 means no price available for that day",
                                        "example": []
                                      },
                                      "listPriceTrend": {
                                        "type": "array",
                                        "description": "Original price trend (strikethrough price history), in local currency smallest unit, -1 means no price available for that day",
                                        "example": []
                                      },
                                      "dealTrend": {
                                        "type": "array",
                                        "description": "Deal trend, value 1 = has deal, 0 = no deal",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "costTime": 1,
                    "costToken": 1,
                    "requestConsumed": 1,
                    "columns": [],
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "asinUrl": "B072MQ5BRX",
                        "imageUrl": "https://example.com/image.jpg",
                        "productImageUrls": [],
                        "ebcPhoto": [],
                        "productBadge": [],
                        "lastUpdate": "2026-01-01",
                        "offSale": false,
                        "size": [],
                        "parentAsin": "B072MQ5BRX",
                        "variationNum": 1,
                        "variationASIN": [],
                        "attribute": [],
                        "price": 1,
                        "coupon": 1,
                        "platformFee": 1,
                        "fbaFees": 1,
                        "fbaDetail": [],
                        "shipCost": 1,
                        "profitAmount": 1,
                        "profitRate": 1,
                        "monthlySalesUnits": 1,
                        "salesRank": 1,
                        "category": [],
                        "bsrCategory": [],
                        "availableDate": "2026-01-01",
                        "onlineDays": 1,
                        "rating": 1,
                        "ratings": 1,
                        "fiveStarRatings": 1,
                        "fourStarRatings": 1,
                        "threeStarRatings": 1,
                        "twoStarRatings": 1,
                        "oneStarRatings": 1,
                        "buyBoxSellerId": "example-id",
                        "isFBA": false,
                        "sellerNum": 1,
                        "aPlus": false,
                        "hasVideo": false,
                        "hasBrandStore": false,
                        "feature": {},
                        "productInfo": {},
                        "property": {},
                        "extraSavings": [],
                        "rankTrend": [],
                        "bsrRankTrend": [],
                        "listingSalesVolumeOfDailyTrend": [],
                        "listingSalesOfDailyTrend": [],
                        "listingSalesVolumeOfMonthTrend": [],
                        "listingSalesOfMonthTrend": [],
                        "priceTrend": [],
                        "listPriceTrend": [],
                        "dealTrend": []
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-market-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_market_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-market-product-search/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Market Product Search",
        "description": "Multi-dimensional Amazon product search and filtering based on Nexscope data, covering 14 marketplaces, with support for historical monthly snapshot lookback. Trigger when the user mentions Nexscope product search, Amazon product filtering, competitor research, category analysis, brand bestsellers, seller analysis, seasonal products, historical snapshot review, product search, monthly sales/revenue, ABA keyword product discovery, price range filtering, new product discovery, multi-condition combined filtering, product search, competitor research, category analysis, brand bestsellers, seller analysis, seasonal products, historical snapshot. Even if the user does not explicitly mention \"Nexscope\", if their need involves Amazon product search, filtering, comparison, or product exploration by category/brand/seller dimensions, this skill should also be triggered.",
        "operationId": "runAmazonMarketProductSearch",
        "externalDocs": {
          "description": "Amazon Market Product Search documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-market-product-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-market-product-search.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa",
                    "example": "us"
                  },
                  "queryMode": {
                    "type": "integer",
                    "description": "Query mode. 1: single condition query (default); 2: multi-condition combined query (AND relationship)",
                    "example": 1
                  },
                  "queryType": {
                    "type": "integer",
                    "description": "Query type (1-16), only effective when queryMode=1. See the complete Query Types description in SKILL.md",
                    "example": 1
                  },
                  "queryValue": {
                    "type": "string",
                    "description": "Query condition value, format varies by queryMode and queryType. See the format description for each queryType in SKILL.md",
                    "example": "phone case"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, default 1. Max 100 products per page",
                    "example": 1
                  },
                  "queryMonth": {
                    "type": "string",
                    "description": "Historical month lookback, format yyyy-MM. When not specified, queries real-time data",
                    "example": "2026-01"
                  }
                },
                "required": [
                  "marketplace"
                ],
                "example": {
                  "queryMode": 1,
                  "marketplace": "us",
                  "queryType": 1,
                  "queryValue": "B072MQ5BRX",
                  "page": 1
                },
                "additionalProperties": true
              },
              "example": {
                "queryMode": 1,
                "marketplace": "us",
                "queryType": 1,
                "queryValue": "B072MQ5BRX",
                "page": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total result count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page number",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count (max 200 pages)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Latency (ms)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "requestConsumed": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Requests consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Product link, Amazon Listing detail page URL",
                                        "example": "B072MQ5BRX"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Main image list (all product image URLs)",
                                        "example": []
                                      },
                                      "parentAsin": {
                                        "type": "string",
                                        "description": "Parent ASIN, the parent ASIN if variants exist, null if no variants",
                                        "example": "B072MQ5BRX"
                                      },
                                      "variationNum": {
                                        "type": "integer",
                                        "description": "Number of variations",
                                        "example": 1
                                      },
                                      "weight": {
                                        "type": "string",
                                        "description": "Weight, unit g",
                                        "example": null
                                      },
                                      "size": {
                                        "type": "array",
                                        "description": "Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm",
                                        "example": []
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current price, before coupon, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "Strikethrough price, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "salesPrice": {
                                        "type": "number",
                                        "description": "Final price, actual price after coupon deduction, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "coupon": {
                                        "type": "integer",
                                        "description": "Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount)",
                                        "example": 1
                                      },
                                      "fbaFees": {
                                        "type": "number",
                                        "description": "FBA fees, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "fbaDetail": {
                                        "type": "array",
                                        "description": "FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,\"1-9:5\",\"10-12:15\"]",
                                        "example": []
                                      },
                                      "platformFee": {
                                        "type": "number",
                                        "description": "Platform commission, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "profitAmount": {
                                        "type": "number",
                                        "description": "Profit, final price - FBA fee - commission, in local currency (e.g. USD)",
                                        "example": 1
                                      },
                                      "profitRate": {
                                        "type": "number",
                                        "description": "Profit margin, e.g. 25.83 means 25.83%",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Monthly sales volume, last 30 days Listing-level (does not split by variant), recommended for evaluating sales, value -1 means unable to estimate",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Monthly sales revenue, estimated value, in local currency (e.g. USD), value -1 means unable to estimate",
                                        "example": 1
                                      },
                                      "listingSalesVolumeOfDaily": {
                                        "type": "integer",
                                        "description": "Daily sales volume, Listing-level (does not split by variant), value -1 means unable to estimate",
                                        "example": 1
                                      },
                                      "listingSalesOfDaily": {
                                        "type": "number",
                                        "description": "Daily sales revenue, in local currency (e.g. USD), value -1 means unable to estimate",
                                        "example": 1
                                      },
                                      "salesRank": {
                                        "type": "integer",
                                        "description": "BSR rank, main category rank",
                                        "example": 1
                                      },
                                      "category": {
                                        "type": "array",
                                        "description": "Main category, [category name, NodeId]",
                                        "example": []
                                      },
                                      "bsrCategory": {
                                        "type": "array",
                                        "description": "Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd)",
                                        "example": []
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Current rating (0.0-5.0, e.g. 4.8)",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Number of ratings",
                                        "example": 1
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time, format yyyy-MM-dd",
                                        "example": "2026-01-01"
                                      },
                                      "onlineDays": {
                                        "type": "integer",
                                        "description": "Days since listing",
                                        "example": 1
                                      },
                                      "buyboxSeller": {
                                        "type": "string",
                                        "description": "Buybox seller name",
                                        "example": null
                                      },
                                      "buyBoxSellerId": {
                                        "type": "string",
                                        "description": "Buybox seller ID",
                                        "example": "example-id"
                                      },
                                      "buyboxSellerAddress": {
                                        "type": "string",
                                        "description": "Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own",
                                        "example": null
                                      },
                                      "isFBA": {
                                        "type": "boolean",
                                        "description": "Whether FBA, whether Buybox seller uses FBA logistics",
                                        "example": false
                                      },
                                      "sellerNum": {
                                        "type": "integer",
                                        "description": "Number of sellers",
                                        "example": 1
                                      },
                                      "aPlus": {
                                        "type": "boolean",
                                        "description": "Has A+",
                                        "example": false
                                      },
                                      "hasVideo": {
                                        "type": "boolean",
                                        "description": "Has video",
                                        "example": false
                                      },
                                      "hasBrandStore": {
                                        "type": "boolean",
                                        "description": "Has brand store",
                                        "example": false
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "page": 1,
                    "pageCount": 1,
                    "costTime": 1,
                    "costToken": 1,
                    "requestConsumed": 1,
                    "columns": [],
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "asinUrl": "B072MQ5BRX",
                        "imageUrl": "https://example.com/image.jpg",
                        "productImageUrls": [],
                        "parentAsin": "B072MQ5BRX",
                        "variationNum": 1,
                        "size": [],
                        "price": 1,
                        "oldPrice": 1,
                        "salesPrice": 1,
                        "coupon": 1,
                        "fbaFees": 1,
                        "fbaDetail": [],
                        "platformFee": 1,
                        "profitAmount": 1,
                        "profitRate": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "listingSalesVolumeOfDaily": 1,
                        "listingSalesOfDaily": 1,
                        "salesRank": 1,
                        "category": [],
                        "bsrCategory": [],
                        "rating": 1,
                        "ratings": 1,
                        "availableDate": "2026-01-01",
                        "onlineDays": 1,
                        "buyBoxSellerId": "example-id",
                        "isFBA": false,
                        "sellerNum": 1,
                        "aPlus": false,
                        "hasVideo": false,
                        "hasBrandStore": false
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-market-product-search",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_market_product_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-market-research/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Market Research",
        "description": "Use Nexscope market list capability to filter Amazon niche markets by category dimensions, supporting market size, competition, top concentration, seller structure, new product share, price/rating/margin ranges, and many other criteria for discovering viable markets and evaluating product selection directions. Trigger when the user mentions Amazon market research, niche category research, market opportunity screening, market concentration analysis, new product opportunities, market selection, Nexscope market research, category market research. Even if the user does not explicitly mention \"Nexscope\", if the need is to screen and evaluate Amazon markets by category dimensions, this skill should also be triggered.",
        "operationId": "runAmazonMarketResearch",
        "externalDocs": {
          "description": "Amazon Market Research documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-market-research"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-market-research.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Site code, see [marketplace](#marketplace-options)",
                    "example": "US"
                  },
                  "nodeIdPath": {
                    "type": "string",
                    "description": "Category node ID path, e.g. 172282:281407"
                  },
                  "departmentKeyword": {
                    "type": "string",
                    "description": "Category keyword path, e.g. Electronics:Accessories & Supplies",
                    "example": "phone case"
                  },
                  "sellerLocation": {
                    "type": "string",
                    "description": "Seller location, multiple values comma-separated; see Nexscope table 1.3 for values"
                  },
                  "newProduct": {
                    "type": "integer",
                    "description": "New product definition (months)",
                    "example": 1
                  },
                  "topNum": {
                    "type": "integer",
                    "description": "Top Listing count",
                    "example": 1
                  },
                  "month": {
                    "type": "string",
                    "description": "Filter date: nearly or yyyyMM"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting from 1",
                    "example": 1
                  },
                  "size": {
                    "type": "integer",
                    "description": "Results per page",
                    "example": 1
                  },
                  "orderField": {
                    "type": "string",
                    "description": "Sort field, see [orderField](#orderfield-options)"
                  },
                  "orderDesc": {
                    "type": "boolean",
                    "description": "true descending, false ascending",
                    "example": false
                  },
                  "minAvgRevenue/maxAvgRevenue": {
                    "type": "number",
                    "description": "Minimum / maximum average monthly sales revenue",
                    "example": 1
                  },
                  "minAvgUnits/maxAvgUnits": {
                    "type": "integer",
                    "description": "Minimum / maximum average monthly sales volume",
                    "example": 1
                  },
                  "minGoodsCount/maxGoodsCount": {
                    "type": "integer",
                    "description": "Minimum / maximum product count",
                    "example": 1
                  },
                  "minSellers/maxSellers": {
                    "type": "integer",
                    "description": "Minimum / maximum seller count",
                    "example": 1
                  },
                  "minBrands/maxBrands": {
                    "type": "integer",
                    "description": "Minimum / maximum brand count",
                    "example": 1
                  },
                  "minAvgSellers/maxAvgSellers": {
                    "type": "number",
                    "description": "Minimum / maximum average seller count",
                    "example": 1
                  },
                  "minGoodsCrn/maxGoodsCrn": {
                    "type": "number",
                    "description": "Minimum / maximum product concentration (decimal 0-1)",
                    "example": 1
                  },
                  "minSellerCrn/maxSellerCrn": {
                    "type": "number",
                    "description": "Minimum / maximum seller concentration (decimal 0-1)",
                    "example": 1
                  },
                  "minBrandCrn/maxBrandCrn": {
                    "type": "number",
                    "description": "Minimum / maximum brand concentration (decimal 0-1)",
                    "example": 1
                  },
                  "minAmazonSelfProportion/maxAmazonSelfProportion": {
                    "type": "number",
                    "description": "Minimum / maximum Amazon self-operated share (decimal 0-1)",
                    "example": 1
                  },
                  "minFbaProportion/maxFbaProportion": {
                    "type": "number",
                    "description": "Minimum / maximum FBA share (decimal 0-1)",
                    "example": 1
                  },
                  "minFbmProportion/maxFbmProportion": {
                    "type": "number",
                    "description": "Minimum / maximum FBM share (decimal 0-1)",
                    "example": 1
                  },
                  "minEbcProportion/maxEbcProportion": {
                    "type": "number",
                    "description": "Minimum / maximum A+ share (decimal 0-1)",
                    "example": 1
                  },
                  "minNewProportion/maxNewProportion": {
                    "type": "number",
                    "description": "Minimum / maximum new product share (scale may differ from other ratio fields; refer to tool schema / actual network behavior)",
                    "example": 1
                  },
                  "minAvgPrice/maxAvgPrice": {
                    "type": "number",
                    "description": "Minimum / maximum average price",
                    "example": 1
                  },
                  "minAvgRating/maxAvgRating": {
                    "type": "number",
                    "description": "Minimum / maximum average rating value",
                    "example": 1
                  },
                  "minAvgRatings/maxAvgRatings": {
                    "type": "integer",
                    "description": "Minimum / maximum average review count",
                    "example": 1
                  },
                  "minAvgProfit/maxAvgProfit": {
                    "type": "number",
                    "description": "Minimum / maximum average gross margin (input N means N%, 0-100)",
                    "example": 1
                  },
                  "minAvgBsr/maxAvgBsr": {
                    "type": "integer",
                    "description": "Minimum / maximum average BSR rank",
                    "example": 1
                  },
                  "minNewCount/maxNewCount": {
                    "type": "integer",
                    "description": "Minimum / maximum new product count",
                    "example": 1
                  },
                  "minNewAvgPrice/maxNewAvgPrice": {
                    "type": "number",
                    "description": "Minimum / maximum new product average price",
                    "example": 1
                  },
                  "minNewAvgRating/maxNewAvgRating": {
                    "type": "number",
                    "description": "Minimum / maximum new product average star rating",
                    "example": 1
                  },
                  "minNewAvgRatings/maxNewAvgRatings": {
                    "type": "integer",
                    "description": "Minimum / maximum new product average review count",
                    "example": 1
                  },
                  "minNewAvgUnits/maxNewAvgUnits": {
                    "type": "number",
                    "description": "Minimum / maximum new product average monthly sales",
                    "example": 1
                  },
                  "minNewAvgRevenue/maxNewAvgRevenue": {
                    "type": "number",
                    "description": "Minimum / maximum new product average monthly revenue",
                    "example": 1
                  },
                  "minTopAvgUnits/maxTopAvgUnits": {
                    "type": "integer",
                    "description": "Minimum / maximum top listing average monthly sales",
                    "example": 1
                  },
                  "minTopAvgRevenue/maxTopAvgRevenue": {
                    "type": "number",
                    "description": "Minimum / maximum top listing average monthly revenue",
                    "example": 1
                  },
                  "minTopAvgBsr/maxTopAvgBsr": {
                    "type": "integer",
                    "description": "Minimum / maximum top listing average BSR",
                    "example": 1
                  },
                  "minWeight/maxWeight": {
                    "type": "number",
                    "description": "Minimum / maximum weight",
                    "example": 1
                  },
                  "minVolume/maxVolume": {
                    "type": "number",
                    "description": "Minimum / maximum volume",
                    "example": 1
                  }
                },
                "required": [
                  "marketplace"
                ],
                "example": {
                  "page": 1,
                  "topNum": 1,
                  "marketplace": "US",
                  "size": 1,
                  "newProduct": 1,
                  "departmentKeyword": "phone case"
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "topNum": 1,
                "marketplace": "US",
                "size": 1,
                "newProduct": 1,
                "departmentKeyword": "phone case"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "marketplace": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Site code",
                                  "example": "US"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Category market list (corresponds to third-party data.items)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nodeId": {
                                        "type": "string",
                                        "description": "Node ID",
                                        "example": "example-id"
                                      },
                                      "nodeIdPath": {
                                        "type": "string",
                                        "description": "Node ID path",
                                        "example": null
                                      },
                                      "nodeLabelName": {
                                        "type": "string",
                                        "description": "Node name",
                                        "example": null
                                      },
                                      "nodeLabelPath": {
                                        "type": "string",
                                        "description": "Node name path",
                                        "example": null
                                      },
                                      "nodeLabelLocale": {
                                        "type": "string",
                                        "description": "Node name translation",
                                        "example": null
                                      },
                                      "nodeLabelPathLocale": {
                                        "type": "string",
                                        "description": "Node name path translation",
                                        "example": null
                                      },
                                      "marketplace": {
                                        "type": "string",
                                        "description": "Market identifier",
                                        "example": "US"
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency type for this market",
                                        "example": null
                                      },
                                      "ranking": {
                                        "type": "integer",
                                        "description": "Rank",
                                        "example": 1
                                      },
                                      "totalProducts": {
                                        "type": "integer",
                                        "description": "Total product count",
                                        "example": 1
                                      },
                                      "topProducts": {
                                        "type": "integer",
                                        "description": "Sample count",
                                        "example": 1
                                      },
                                      "sellers": {
                                        "type": "integer",
                                        "description": "Seller count",
                                        "example": 1
                                      },
                                      "brands": {
                                        "type": "integer",
                                        "description": "Brand count",
                                        "example": 1
                                      },
                                      "avgSellers": {
                                        "type": "number",
                                        "description": "Average seller count",
                                        "example": 1
                                      },
                                      "avgUnits": {
                                        "type": "integer",
                                        "description": "Average monthly sales volume",
                                        "example": 1
                                      },
                                      "totalUnits": {
                                        "type": "integer",
                                        "description": "Total monthly sales volume",
                                        "example": 1
                                      },
                                      "avgRevenue": {
                                        "type": "number",
                                        "description": "Average monthly sales revenue",
                                        "example": 1
                                      },
                                      "totalRevenue": {
                                        "type": "number",
                                        "description": "Total monthly sales revenue",
                                        "example": 1
                                      },
                                      "avgPrice": {
                                        "type": "number",
                                        "description": "Average price",
                                        "example": 1
                                      },
                                      "avgRating": {
                                        "type": "number",
                                        "description": "Average rating value",
                                        "example": 1
                                      },
                                      "avgRatings": {
                                        "type": "integer",
                                        "description": "Average review count",
                                        "example": 1
                                      },
                                      "avgBsr": {
                                        "type": "integer",
                                        "description": "Average BSR",
                                        "example": 1
                                      },
                                      "avgProfit": {
                                        "type": "number",
                                        "description": "Average profit margin (%)",
                                        "example": 1
                                      },
                                      "fbaProportion": {
                                        "type": "number",
                                        "description": "FBA share (%)",
                                        "example": 1
                                      },
                                      "fbmProportion": {
                                        "type": "number",
                                        "description": "FBM share (%)",
                                        "example": 1
                                      },
                                      "amazonSelfProportion": {
                                        "type": "number",
                                        "description": "Amazon self-operated share (%)",
                                        "example": 1
                                      },
                                      "ebcProportion": {
                                        "type": "number",
                                        "description": "A+ product share (%)",
                                        "example": 1
                                      },
                                      "returnRatio": {
                                        "type": "number",
                                        "description": "Return rate (%)",
                                        "example": 1
                                      },
                                      "avgReturnRatio": {
                                        "type": "number",
                                        "description": "Category average return rate (%)",
                                        "example": 1
                                      },
                                      "searchToPurchaseRatio": {
                                        "type": "number",
                                        "description": "Search-to-purchase ratio (per mille)",
                                        "example": 1
                                      },
                                      "sellerNation": {
                                        "type": "string",
                                        "description": "Most common seller location code",
                                        "example": null
                                      },
                                      "sellerNationLabel": {
                                        "type": "string",
                                        "description": "Most common seller location label",
                                        "example": null
                                      },
                                      "sellerProportion": {
                                        "type": "number",
                                        "description": "Most common seller location share (%)",
                                        "example": 1
                                      },
                                      "avgWeight": {
                                        "type": "number",
                                        "description": "Average weight (pound)",
                                        "example": 1
                                      },
                                      "baseAvgWeight": {
                                        "type": "number",
                                        "description": "Average weight (g)",
                                        "example": 1
                                      },
                                      "avgVolume": {
                                        "type": "number",
                                        "description": "Average volume (in³)",
                                        "example": 1
                                      },
                                      "baseAvgVolume": {
                                        "type": "number",
                                        "description": "Average volume (cm³)",
                                        "example": 1
                                      },
                                      "top10Images": {
                                        "type": "array",
                                        "description": "Top 10 product images, elements see table below",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "image": {
                                              "type": "string",
                                              "description": "Image link",
                                              "example": "https://example.com/image.jpg"
                                            },
                                            "asin": {
                                              "type": "string",
                                              "description": "ASIN",
                                              "example": "B072MQ5BRX"
                                            }
                                          }
                                        }
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "marketplace": "US",
                    "data": [
                      {
                        "nodeId": "example-id",
                        "marketplace": "US",
                        "ranking": 1,
                        "totalProducts": 1,
                        "topProducts": 1,
                        "sellers": 1,
                        "brands": 1,
                        "avgSellers": 1,
                        "avgUnits": 1,
                        "totalUnits": 1,
                        "avgRevenue": 1,
                        "totalRevenue": 1,
                        "avgPrice": 1,
                        "avgRating": 1,
                        "avgRatings": 1,
                        "avgBsr": 1,
                        "avgProfit": 1,
                        "fbaProportion": 1,
                        "fbmProportion": 1,
                        "amazonSelfProportion": 1,
                        "ebcProportion": 1,
                        "returnRatio": 1,
                        "avgReturnRatio": 1,
                        "searchToPurchaseRatio": 1,
                        "sellerProportion": 1,
                        "avgWeight": 1,
                        "baseAvgWeight": 1,
                        "avgVolume": 1,
                        "baseAvgVolume": 1,
                        "top10Images": [
                          {
                            "image": "https://example.com/image.jpg",
                            "asin": "B072MQ5BRX"
                          }
                        ]
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-market-research",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_market_research",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-market-statistics/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Market Statistics",
        "description": "Use Nexscope market statistics capability to output a market statistics dashboard by category node, including top listing average rating, average price, BSR, sales, seller count, and new product related metrics, suitable for quickly assessing the market quality and competitive landscape of a category. Trigger when the user mentions category market statistics, market selection dashboard, market fundamentals assessment, node market quality, top product statistics, Nexscope market statistics, category statistics. Even if the user does not explicitly mention \"Nexscope\", if the need is to view aggregated statistical results by category node, this skill should also be triggered.",
        "operationId": "runAmazonMarketStatistics",
        "externalDocs": {
          "description": "Amazon Market Statistics documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-market-statistics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-market-statistics.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Site code, see [marketplace](#marketplace-options)",
                    "example": "US"
                  },
                  "nodeIdPath": {
                    "type": "string",
                    "description": "Node ID path string, e.g. 1064954:1069242:1069784:1069820:1069838:1069828",
                    "example": "1064954:1069242"
                  },
                  "month": {
                    "type": "string",
                    "description": "Filter date: nearly or yyyyMM"
                  },
                  "topN": {
                    "type": "integer",
                    "description": "Top Listing count (used for top-related metric definitions)",
                    "example": 1
                  },
                  "newProduct": {
                    "type": "integer",
                    "description": "New product definition (months)",
                    "example": 1
                  }
                },
                "required": [
                  "marketplace",
                  "nodeIdPath"
                ],
                "example": {
                  "newProduct": 1,
                  "marketplace": "US",
                  "nodeIdPath": "1064954:1069242",
                  "topN": 1
                },
                "additionalProperties": true
              },
              "example": {
                "newProduct": 1,
                "marketplace": "US",
                "nodeIdPath": "1064954:1069242",
                "topN": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "marketplace": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Site code",
                                  "example": "US"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Statistics result list (corresponds to third-party data)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "marketplace": {
                                        "type": "string",
                                        "description": "Site code for this statistics row",
                                        "example": "US"
                                      },
                                      "nodeIdPath": {
                                        "type": "string",
                                        "description": "Node ID path",
                                        "example": null
                                      },
                                      "nodeLabelPath": {
                                        "type": "string",
                                        "description": "Node name path",
                                        "example": null
                                      },
                                      "nodeLabelLocale": {
                                        "type": "string",
                                        "description": "Node name translation",
                                        "example": null
                                      },
                                      "nodeLabelPathLocale": {
                                        "type": "string",
                                        "description": "Node name path translation",
                                        "example": null
                                      },
                                      "countryCode": {
                                        "type": "string",
                                        "description": "Two-letter country code",
                                        "example": null
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency type for this market",
                                        "example": null
                                      },
                                      "totalProducts": {
                                        "type": "integer",
                                        "description": "Total product count",
                                        "example": 1
                                      },
                                      "products": {
                                        "type": "integer",
                                        "description": "Sample product count",
                                        "example": 1
                                      },
                                      "sellers": {
                                        "type": "integer",
                                        "description": "Seller count",
                                        "example": 1
                                      },
                                      "brands": {
                                        "type": "integer",
                                        "description": "Brand count",
                                        "example": 1
                                      },
                                      "avgSellers": {
                                        "type": "number",
                                        "description": "Average seller count",
                                        "example": 1
                                      },
                                      "hlProducts": {
                                        "type": "integer",
                                        "description": "Top N Listing sample product count",
                                        "example": 1
                                      },
                                      "avgUnits": {
                                        "type": "integer",
                                        "description": "Average monthly sales volume",
                                        "example": 1
                                      },
                                      "avgRevenue": {
                                        "type": "number",
                                        "description": "Average monthly sales revenue",
                                        "example": 1
                                      },
                                      "avgPrice": {
                                        "type": "number",
                                        "description": "Average price",
                                        "example": 1
                                      },
                                      "avgRating": {
                                        "type": "number",
                                        "description": "Average star rating",
                                        "example": 1
                                      },
                                      "avgRatings": {
                                        "type": "integer",
                                        "description": "Average review count",
                                        "example": 1
                                      },
                                      "avgRatingsCv": {
                                        "type": "integer",
                                        "description": "Average monthly review growth count",
                                        "example": 1
                                      },
                                      "avgBsr": {
                                        "type": "integer",
                                        "description": "Average BSR",
                                        "example": 1
                                      },
                                      "avgProfit": {
                                        "type": "number",
                                        "description": "Average profit margin",
                                        "example": 1
                                      },
                                      "avgWeight": {
                                        "type": "number",
                                        "description": "Average weight (pound)",
                                        "example": 1
                                      },
                                      "baseAvgWeight": {
                                        "type": "number",
                                        "description": "Average weight (g)",
                                        "example": 1
                                      },
                                      "avgVolume": {
                                        "type": "number",
                                        "description": "Average volume (in³)",
                                        "example": 1
                                      },
                                      "baseAvgVolume": {
                                        "type": "number",
                                        "description": "Average volume (cm³)",
                                        "example": 1
                                      },
                                      "hlAvgUnits": {
                                        "type": "integer",
                                        "description": "Top N Listing average monthly sales volume",
                                        "example": 1
                                      },
                                      "hlAvgRevenue": {
                                        "type": "number",
                                        "description": "Top N Listing average monthly sales revenue",
                                        "example": 1
                                      },
                                      "hlAvgPrice": {
                                        "type": "number",
                                        "description": "Top N Listing average price",
                                        "example": 1
                                      },
                                      "hlAvgRating": {
                                        "type": "number",
                                        "description": "Top N Listing average star rating",
                                        "example": 1
                                      },
                                      "hlAvgRatings": {
                                        "type": "integer",
                                        "description": "Top N Listing average review count",
                                        "example": 1
                                      },
                                      "hlAvgRatingsCv": {
                                        "type": "integer",
                                        "description": "Top N Listing average monthly review growth count",
                                        "example": 1
                                      },
                                      "hlAvgBsr": {
                                        "type": "integer",
                                        "description": "Top N Listing average BSR",
                                        "example": 1
                                      },
                                      "newProducts": {
                                        "type": "integer",
                                        "description": "New product count",
                                        "example": 1
                                      },
                                      "newProductProportion": {
                                        "type": "number",
                                        "description": "New product share",
                                        "example": 1
                                      },
                                      "newAvgUnits": {
                                        "type": "integer",
                                        "description": "New product average monthly sales volume",
                                        "example": 1
                                      },
                                      "newAvgRevenue": {
                                        "type": "number",
                                        "description": "New product average monthly sales revenue",
                                        "example": 1
                                      },
                                      "newAvgPrice": {
                                        "type": "number",
                                        "description": "New product average price",
                                        "example": 1
                                      },
                                      "newAvgRating": {
                                        "type": "number",
                                        "description": "New product average star rating",
                                        "example": 1
                                      },
                                      "newAvgRatings": {
                                        "type": "integer",
                                        "description": "New product average review count",
                                        "example": 1
                                      },
                                      "minNewRatings": {
                                        "type": "integer",
                                        "description": "Minimum new product review count",
                                        "example": 1
                                      },
                                      "maxNewRatings": {
                                        "type": "integer",
                                        "description": "Maximum new product review count",
                                        "example": 1
                                      },
                                      "firstShelfDate": {
                                        "type": "string",
                                        "description": "Product first listing date",
                                        "example": "2026-01-01"
                                      },
                                      "lastShelfDate": {
                                        "type": "string",
                                        "description": "Product latest listing date",
                                        "example": "2026-01-01"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "marketplace": "US",
                    "data": [
                      {
                        "marketplace": "US",
                        "totalProducts": 1,
                        "products": 1,
                        "sellers": 1,
                        "brands": 1,
                        "avgSellers": 1,
                        "hlProducts": 1,
                        "avgUnits": 1,
                        "avgRevenue": 1,
                        "avgPrice": 1,
                        "avgRating": 1,
                        "avgRatings": 1,
                        "avgRatingsCv": 1,
                        "avgBsr": 1,
                        "avgProfit": 1,
                        "avgWeight": 1,
                        "baseAvgWeight": 1,
                        "avgVolume": 1,
                        "baseAvgVolume": 1,
                        "hlAvgUnits": 1,
                        "hlAvgRevenue": 1,
                        "hlAvgPrice": 1,
                        "hlAvgRating": 1,
                        "hlAvgRatings": 1,
                        "hlAvgRatingsCv": 1,
                        "hlAvgBsr": 1,
                        "newProducts": 1,
                        "newProductProportion": 1,
                        "newAvgUnits": 1,
                        "newAvgRevenue": 1,
                        "newAvgPrice": 1,
                        "newAvgRating": 1,
                        "newAvgRatings": 1,
                        "minNewRatings": 1,
                        "maxNewRatings": 1,
                        "firstShelfDate": "2026-01-01",
                        "lastShelfDate": "2026-01-01"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-market-statistics",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_market_statistics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-niche-info/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Niche Info",
        "description": "Query and analyze Nexscope data for Amazon niche market insights, including market metrics, buyer reviews, competitive landscape, price trends, and growth trends. Trigger when the user mentions niche market analysis, market insights, niche market data, market competition analysis, brand concentration, new product launch success rate, out-of-stock rate, price trends, review insights, market demand score, niche market insights, market metrics, competition analysis, price trends, growth trends, Nexscope data, market intelligence, out-of-stock rate. Even if the user does not explicitly mention \"Nexscope\" or \"niche market\", if their need involves querying market-level intelligence for a specific Amazon niche market by market ID, this skill should also be triggered.",
        "operationId": "runAmazonNicheInfo",
        "externalDocs": {
          "description": "Amazon Niche Info documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-niche-info"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-niche-info.",
                "properties": {
                  "nicheId": {
                    "type": "string",
                    "description": "Niche market ID, max length 1000 characters, only supports single ID query",
                    "example": "dfecfecfa9701de73a08867d7bcd3bc0"
                  },
                  "countryCode": {
                    "type": "string",
                    "description": "Country code, only supports US, JP, DE, default US"
                  }
                },
                "required": [
                  "nicheId"
                ],
                "example": {
                  "countryCode": "US",
                  "nicheId": "dfecfecfa9701de73a08867d7bcd3bc0"
                },
                "additionalProperties": true
              },
              "example": {
                "countryCode": "US",
                "nicheId": "dfecfecfa9701de73a08867d7bcd3bc0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Niche market information list, each element is an object containing the fields below",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nicheId": {
                                        "type": "string",
                                        "description": "Niche market ID",
                                        "example": "dfecfecfa9701de73a08867d7bcd3bc0"
                                      },
                                      "nicheTitle": {
                                        "type": "string",
                                        "description": "Niche market title",
                                        "example": null
                                      },
                                      "translationZh": {
                                        "type": "string",
                                        "description": "Niche market title (Chinese)",
                                        "example": null
                                      },
                                      "referenceAsinImageUrl": {
                                        "type": "string",
                                        "description": "Niche market reference image URL",
                                        "example": "B072MQ5BRX"
                                      },
                                      "marketplaceId": {
                                        "type": "string",
                                        "description": "Market ID",
                                        "example": "US"
                                      },
                                      "demand": {
                                        "type": "integer",
                                        "description": "Niche market score",
                                        "example": 1
                                      },
                                      "categorieList": {
                                        "type": "array",
                                        "description": "Product category list",
                                        "example": []
                                      },
                                      "productCount": {
                                        "type": "integer",
                                        "description": "Product count",
                                        "example": 1
                                      },
                                      "productCountNow": {
                                        "type": "integer",
                                        "description": "Product count (current)",
                                        "example": 1
                                      },
                                      "productCountT90Before": {
                                        "type": "integer",
                                        "description": "Product count (90 days ago)",
                                        "example": 1
                                      },
                                      "productCountT360Before": {
                                        "type": "integer",
                                        "description": "Product count (360 days ago)",
                                        "example": 1
                                      },
                                      "brandCount": {
                                        "type": "integer",
                                        "description": "Brand count",
                                        "example": 1
                                      },
                                      "brandCountNow": {
                                        "type": "integer",
                                        "description": "Brand count (current)",
                                        "example": 1
                                      },
                                      "brandCountT90Before": {
                                        "type": "integer",
                                        "description": "Brand count (90 days ago)",
                                        "example": 1
                                      },
                                      "brandCountT360Before": {
                                        "type": "integer",
                                        "description": "Brand count (360 days ago)",
                                        "example": 1
                                      },
                                      "brandCountT360Now": {
                                        "type": "integer",
                                        "description": "Brand count (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "brandCountT360T90Before": {
                                        "type": "integer",
                                        "description": "Brand count (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "brandCountT360T360Before": {
                                        "type": "integer",
                                        "description": "Brand count (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "sellingPartnerCountNow": {
                                        "type": "integer",
                                        "description": "Selling partner count (current)",
                                        "example": 1
                                      },
                                      "sellingPartnerCountT90Before": {
                                        "type": "integer",
                                        "description": "Selling partner count (90 days ago)",
                                        "example": 1
                                      },
                                      "sellingPartnerCountT360Before": {
                                        "type": "integer",
                                        "description": "Selling partner count (360 days ago)",
                                        "example": 1
                                      },
                                      "sellingPartnerCountT360Now": {
                                        "type": "integer",
                                        "description": "Selling partner count (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "sellingPartnerCountT360T90Before": {
                                        "type": "integer",
                                        "description": "Selling partner count (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "sellingPartnerCountT360T360Before": {
                                        "type": "integer",
                                        "description": "Selling partner count (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "avgPrice": {
                                        "type": "number",
                                        "description": "Average product price",
                                        "example": 1
                                      },
                                      "avgProductPriceNow": {
                                        "type": "number",
                                        "description": "Average product price (current)",
                                        "example": 1
                                      },
                                      "avgProductPriceT90Before": {
                                        "type": "number",
                                        "description": "Average product price (90 days ago)",
                                        "example": 1
                                      },
                                      "avgProductPriceT360Before": {
                                        "type": "number",
                                        "description": "Average product price (360 days ago)",
                                        "example": 1
                                      },
                                      "minimumPrice": {
                                        "type": "number",
                                        "description": "Lowest product price",
                                        "example": 1
                                      },
                                      "maximumPrice": {
                                        "type": "number",
                                        "description": "Highest product price",
                                        "example": 1
                                      },
                                      "searchVolumeWeekly": {
                                        "type": "integer",
                                        "description": "Search volume (weekly data)",
                                        "example": 1
                                      },
                                      "searchVolumeQuarterly": {
                                        "type": "integer",
                                        "description": "Search volume (quarterly data)",
                                        "example": 1
                                      },
                                      "searchVolumeGrowthWeekly": {
                                        "type": "number",
                                        "description": "Search volume growth rate (weekly data)",
                                        "example": 1
                                      },
                                      "searchVolumeGrowthQuarterly": {
                                        "type": "number",
                                        "description": "Search volume growth rate (quarterly data)",
                                        "example": 1
                                      },
                                      "searchConversionRateWeekly": {
                                        "type": "number",
                                        "description": "Search conversion rate (weekly data)",
                                        "example": 1
                                      },
                                      "searchConversionRateQuarterly": {
                                        "type": "number",
                                        "description": "Search conversion rate (quarterly data)",
                                        "example": 1
                                      },
                                      "clickCountWeekly": {
                                        "type": "integer",
                                        "description": "Click volume (weekly data)",
                                        "example": 1
                                      },
                                      "clickCountQuarterly": {
                                        "type": "integer",
                                        "description": "Click volume (quarterly data)",
                                        "example": 1
                                      },
                                      "clickConversionRateQuarterly": {
                                        "type": "number",
                                        "description": "Click conversion rate (quarterly data)",
                                        "example": 1
                                      },
                                      "clickToSaleConversionWeekly": {
                                        "type": "number",
                                        "description": "Click conversion rate (weekly data)",
                                        "example": 1
                                      },
                                      "unitsSoldWeekly": {
                                        "type": "integer",
                                        "description": "Sales volume (weekly data)",
                                        "example": 1
                                      },
                                      "unitsSoldQuarterly": {
                                        "type": "integer",
                                        "description": "Sales volume (quarterly data)",
                                        "example": 1
                                      },
                                      "top5ProductsClickShare": {
                                        "type": "number",
                                        "description": "Top 5 products click share",
                                        "example": 1
                                      },
                                      "top5ProductsClickShareNow": {
                                        "type": "number",
                                        "description": "Top 5 products' click share in the niche market (current)",
                                        "example": 1
                                      },
                                      "top5ProductsClickShareT90Before": {
                                        "type": "number",
                                        "description": "Top 5 products' click share in the niche market (90 days ago)",
                                        "example": 1
                                      },
                                      "top5ProductsClickShareT360Before": {
                                        "type": "number",
                                        "description": "Top 5 products' click share in the niche market (360 days ago)",
                                        "example": 1
                                      },
                                      "top5ProductsClickShareT360Now": {
                                        "type": "number",
                                        "description": "Top 5 products click share (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "top5ProductsClickShareT360T90Before": {
                                        "type": "number",
                                        "description": "Top 5 products click share (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "top5ProductsClickShareT360T360Before": {
                                        "type": "number",
                                        "description": "Top 5 products click share (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "top20ProductsClickShareNow": {
                                        "type": "number",
                                        "description": "Top 20 products' click share in the niche market (current)",
                                        "example": 1
                                      },
                                      "top20ProductsClickShareT90Before": {
                                        "type": "number",
                                        "description": "Top 20 products' click share in the niche market (90 days ago)",
                                        "example": 1
                                      },
                                      "top20ProductsClickShareT360Before": {
                                        "type": "number",
                                        "description": "Top 20 products' click share in the niche market (360 days ago)",
                                        "example": 1
                                      },
                                      "top20ProductsClickShareT360Now": {
                                        "type": "number",
                                        "description": "Top 20 products click share (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "top20ProductsClickShareT360T90Before": {
                                        "type": "number",
                                        "description": "Top 20 products click share (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "top20ProductsClickShareT360T360Before": {
                                        "type": "number",
                                        "description": "Top 20 products click share (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "top5BrandsClickShare": {
                                        "type": "number",
                                        "description": "Top 5 brands' click share in the niche market",
                                        "example": 1
                                      },
                                      "top5BrandsClickShareNow": {
                                        "type": "number",
                                        "description": "Top 5 brands' click share in the niche market (current)",
                                        "example": 1
                                      },
                                      "top5BrandsClickShareT90Before": {
                                        "type": "number",
                                        "description": "Top 5 brands' click share in the niche market (90 days ago)",
                                        "example": 1
                                      },
                                      "top5BrandsClickShareT360Before": {
                                        "type": "number",
                                        "description": "Top 5 brands' click share in the niche market (360 days ago)",
                                        "example": 1
                                      },
                                      "top5BrandsClickShareT360Now": {
                                        "type": "number",
                                        "description": "Top 5 brands' click share in the niche market (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "top5BrandsClickShareT360T90Before": {
                                        "type": "number",
                                        "description": "Top 5 brands' click share in the niche market (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "top5BrandsClickShareT360T360Before": {
                                        "type": "number",
                                        "description": "Top 5 brands' click share in the niche market (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "top20BrandsClickShareNow": {
                                        "type": "number",
                                        "description": "Top 20 brands' click share in the niche market (current)",
                                        "example": 1
                                      },
                                      "top20BrandsClickShareT90Before": {
                                        "type": "number",
                                        "description": "Top 20 brands' click share in the niche market (90 days ago)",
                                        "example": 1
                                      },
                                      "top20BrandsClickShareT360Before": {
                                        "type": "number",
                                        "description": "Top 20 brands' click share in the niche market (360 days ago)",
                                        "example": 1
                                      },
                                      "top20BrandsClickShareT360Now": {
                                        "type": "number",
                                        "description": "Top 20 brands' click share in the niche market (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "top20BrandsClickShareT360T90Before": {
                                        "type": "number",
                                        "description": "Top 20 brands' click share in the niche market (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "top20BrandsClickShareT360T360Before": {
                                        "type": "number",
                                        "description": "Top 20 brands' click share in the niche market (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "newProductsLaunchedSemiannual": {
                                        "type": "integer",
                                        "description": "Number of new products launched (semi-annual data)",
                                        "example": 1
                                      },
                                      "newProductsLaunchedT180Now": {
                                        "type": "integer",
                                        "description": "Number of new products launched (180-day stats) (current)",
                                        "example": 1
                                      },
                                      "newProductsLaunchedT180T90Before": {
                                        "type": "integer",
                                        "description": "Number of new products launched (180-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "newProductsLaunchedT180T360Before": {
                                        "type": "integer",
                                        "description": "Number of new products launched (180-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "newProductsLaunchedT360Now": {
                                        "type": "integer",
                                        "description": "Number of newly listed products (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "newProductsLaunchedT360T90Before": {
                                        "type": "integer",
                                        "description": "Number of newly listed products (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "newProductsLaunchedT360T360Before": {
                                        "type": "integer",
                                        "description": "Number of newly listed products (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "successfulLaunchedSemiannual": {
                                        "type": "integer",
                                        "description": "Number of successfully launched products (semi-annual data)",
                                        "example": 1
                                      },
                                      "launchRateSemiannual": {
                                        "type": "number",
                                        "description": "Product launch success rate (semi-annual data)",
                                        "example": 1
                                      },
                                      "successfulLaunchesT90Now": {
                                        "type": "integer",
                                        "description": "Successfully launched count (90-day stats) (current)",
                                        "example": 1
                                      },
                                      "successfulLaunchesT90T90Before": {
                                        "type": "integer",
                                        "description": "Successfully launched count (90-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "successfulLaunchesT90T360Before": {
                                        "type": "integer",
                                        "description": "Successfully launched count (90-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "successfulLaunchesT180Now": {
                                        "type": "integer",
                                        "description": "Number of successfully launched products (180-day stats) (current)",
                                        "example": 1
                                      },
                                      "successfulLaunchesT180T90Before": {
                                        "type": "integer",
                                        "description": "Number of successfully launched products (180-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "successfulLaunchesT180T360Before": {
                                        "type": "integer",
                                        "description": "Number of successfully launched products (180-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "successfulLaunchesT360Now": {
                                        "type": "integer",
                                        "description": "Number of successfully launched products (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "successfulLaunchesT360T90Before": {
                                        "type": "integer",
                                        "description": "Number of successfully launched products (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "successfulLaunchesT360T360Before": {
                                        "type": "integer",
                                        "description": "Number of successfully launched products (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "avgOOSRateNow": {
                                        "type": "number",
                                        "description": "Average out-of-stock rate (current)",
                                        "example": 1
                                      },
                                      "avgOOSRateT90Before": {
                                        "type": "number",
                                        "description": "Average out-of-stock rate (90 days ago)",
                                        "example": 1
                                      },
                                      "avgOOSRateT360Before": {
                                        "type": "number",
                                        "description": "Average out-of-stock rate (360 days ago)",
                                        "example": 1
                                      },
                                      "avgOOSRateT360Now": {
                                        "type": "number",
                                        "description": "Average out-of-stock rate (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "avgOOSRateT360T90Before": {
                                        "type": "number",
                                        "description": "Average out-of-stock rate (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "avgOOSRateT360T360Before": {
                                        "type": "number",
                                        "description": "Average out-of-stock rate (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "primeProductsPercentageNow": {
                                        "type": "number",
                                        "description": "Prime product percentage (current)",
                                        "example": 1
                                      },
                                      "primeProductsPercentageT90Before": {
                                        "type": "number",
                                        "description": "Prime product percentage (90 days ago)",
                                        "example": 1
                                      },
                                      "primeProductsPercentageT360Before": {
                                        "type": "number",
                                        "description": "Prime product percentage (360 days ago)",
                                        "example": 1
                                      },
                                      "primeProductsPercentageT360Now": {
                                        "type": "number",
                                        "description": "Prime product percentage (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "primeProductsPercentageT360T90Before": {
                                        "type": "number",
                                        "description": "Prime product percentage (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "primeProductsPercentageT360T360Before": {
                                        "type": "number",
                                        "description": "Prime product percentage (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "avgReviewRatingNow": {
                                        "type": "number",
                                        "description": "Average review rating (current)",
                                        "example": 1
                                      },
                                      "avgReviewRatingT90Before": {
                                        "type": "number",
                                        "description": "Average review rating (90 days ago)",
                                        "example": 1
                                      },
                                      "avgReviewRatingT360Before": {
                                        "type": "number",
                                        "description": "Average review rating (360 days ago)",
                                        "example": 1
                                      },
                                      "avgReviewCountNow": {
                                        "type": "number",
                                        "description": "Average review count (current)",
                                        "example": 1
                                      },
                                      "avgReviewCountT90Before": {
                                        "type": "number",
                                        "description": "Average review count (90 days ago)",
                                        "example": 1
                                      },
                                      "avgReviewCountT360Before": {
                                        "type": "number",
                                        "description": "Average review count (360 days ago)",
                                        "example": 1
                                      },
                                      "positiveCustomerReviewInsights": {
                                        "type": "array",
                                        "description": "Positive customer review insights",
                                        "example": []
                                      },
                                      "negativeCustomerReviewInsights": {
                                        "type": "array",
                                        "description": "Negative customer review insights",
                                        "example": []
                                      },
                                      "productStarRatingImpact": {
                                        "type": "array",
                                        "description": "Product star rating impact information",
                                        "example": []
                                      },
                                      "avgBrandAgeNow": {
                                        "type": "number",
                                        "description": "Average brand age (current)",
                                        "example": 1
                                      },
                                      "avgBrandAgeT90Before": {
                                        "type": "number",
                                        "description": "Average brand age (90 days ago)",
                                        "example": 1
                                      },
                                      "avgBrandAgeT360Before": {
                                        "type": "number",
                                        "description": "Average brand age (360 days ago)",
                                        "example": 1
                                      },
                                      "avgBrandAgeQuarterly": {
                                        "type": "number",
                                        "description": "Average brand age (quarterly data)",
                                        "example": 1
                                      },
                                      "avgBrandAgeT360Now": {
                                        "type": "number",
                                        "description": "Average brand age (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "avgBrandAgeT360T90Before": {
                                        "type": "number",
                                        "description": "Average brand age (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "avgBrandAgeT360T360Before": {
                                        "type": "number",
                                        "description": "Average brand age (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "avgSellingPartnerAgeNow": {
                                        "type": "number",
                                        "description": "Average selling partner age (current)",
                                        "example": 1
                                      },
                                      "avgSellingPartnerAgeT90Before": {
                                        "type": "number",
                                        "description": "Average selling partner age (90 days ago)",
                                        "example": 1
                                      },
                                      "avgSellingPartnerAgeT360Before": {
                                        "type": "number",
                                        "description": "Average selling partner age (360 days ago)",
                                        "example": 1
                                      },
                                      "avgBestSellerRankNow": {
                                        "type": "number",
                                        "description": "Average Best Seller rank (current)",
                                        "example": 1
                                      },
                                      "avgBestSellerRankT90Before": {
                                        "type": "number",
                                        "description": "Average Best Seller rank (90 days ago)",
                                        "example": 1
                                      },
                                      "avgBestSellerRankT360Before": {
                                        "type": "number",
                                        "description": "Average Best Seller rank (360 days ago)",
                                        "example": 1
                                      },
                                      "acos": {
                                        "type": "number",
                                        "description": "(ACOS) Advertising Cost of Sale",
                                        "example": 1
                                      },
                                      "sponsoredProductsPercentageNow": {
                                        "type": "number",
                                        "description": "Percentage of products with Sponsored Products ads (current)",
                                        "example": 1
                                      },
                                      "sponsoredProductsPercentageT90Before": {
                                        "type": "number",
                                        "description": "Percentage of products with Sponsored Products ads (90 days ago)",
                                        "example": 1
                                      },
                                      "sponsoredProductsPercentageT360Before": {
                                        "type": "number",
                                        "description": "Percentage of products with Sponsored Products ads (360 days ago)",
                                        "example": 1
                                      },
                                      "sponsoredProductsPercentageT360Now": {
                                        "type": "number",
                                        "description": "Percentage of products with Sponsored Products ads (360-day stats) (current)",
                                        "example": 1
                                      },
                                      "sponsoredProductsPercentageT360T90Before": {
                                        "type": "number",
                                        "description": "Percentage of products with Sponsored Products ads (360-day stats) (90 days ago)",
                                        "example": 1
                                      },
                                      "sponsoredProductsPercentageT360T360Before": {
                                        "type": "number",
                                        "description": "Percentage of products with Sponsored Products ads (360-day stats) (360 days ago)",
                                        "example": 1
                                      },
                                      "profitMarginGt50PctSkuRatio": {
                                        "type": "number",
                                        "description": "Proportion of products with profit margin > 50%",
                                        "example": 1
                                      },
                                      "breakEvenRatio": {
                                        "type": "number",
                                        "description": "Break-even ratio",
                                        "example": 1
                                      },
                                      "returnRateAnnual": {
                                        "type": "number",
                                        "description": "Return rate (annual data)",
                                        "example": 1
                                      },
                                      "cpc": {
                                        "type": "object",
                                        "description": "CPC (Cost Per Click) data",
                                        "example": {}
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "nicheId": "dfecfecfa9701de73a08867d7bcd3bc0",
                        "referenceAsinImageUrl": "B072MQ5BRX",
                        "marketplaceId": "US",
                        "demand": 1,
                        "categorieList": [],
                        "productCount": 1,
                        "productCountNow": 1,
                        "productCountT90Before": 1,
                        "productCountT360Before": 1,
                        "brandCount": 1,
                        "brandCountNow": 1,
                        "brandCountT90Before": 1,
                        "brandCountT360Before": 1,
                        "brandCountT360Now": 1,
                        "brandCountT360T90Before": 1,
                        "brandCountT360T360Before": 1,
                        "sellingPartnerCountNow": 1,
                        "sellingPartnerCountT90Before": 1,
                        "sellingPartnerCountT360Before": 1,
                        "sellingPartnerCountT360Now": 1,
                        "sellingPartnerCountT360T90Before": 1,
                        "sellingPartnerCountT360T360Before": 1,
                        "avgPrice": 1,
                        "avgProductPriceNow": 1,
                        "avgProductPriceT90Before": 1,
                        "avgProductPriceT360Before": 1,
                        "minimumPrice": 1,
                        "maximumPrice": 1,
                        "searchVolumeWeekly": 1,
                        "searchVolumeQuarterly": 1,
                        "searchVolumeGrowthWeekly": 1,
                        "searchVolumeGrowthQuarterly": 1,
                        "searchConversionRateWeekly": 1,
                        "searchConversionRateQuarterly": 1,
                        "clickCountWeekly": 1,
                        "clickCountQuarterly": 1,
                        "clickConversionRateQuarterly": 1,
                        "clickToSaleConversionWeekly": 1,
                        "unitsSoldWeekly": 1,
                        "unitsSoldQuarterly": 1,
                        "top5ProductsClickShare": 1,
                        "top5ProductsClickShareNow": 1,
                        "top5ProductsClickShareT90Before": 1,
                        "top5ProductsClickShareT360Before": 1,
                        "top5ProductsClickShareT360Now": 1,
                        "top5ProductsClickShareT360T90Before": 1,
                        "top5ProductsClickShareT360T360Before": 1,
                        "top20ProductsClickShareNow": 1,
                        "top20ProductsClickShareT90Before": 1,
                        "top20ProductsClickShareT360Before": 1,
                        "top20ProductsClickShareT360Now": 1,
                        "top20ProductsClickShareT360T90Before": 1,
                        "top20ProductsClickShareT360T360Before": 1,
                        "top5BrandsClickShare": 1,
                        "top5BrandsClickShareNow": 1,
                        "top5BrandsClickShareT90Before": 1,
                        "top5BrandsClickShareT360Before": 1,
                        "top5BrandsClickShareT360Now": 1,
                        "top5BrandsClickShareT360T90Before": 1,
                        "top5BrandsClickShareT360T360Before": 1,
                        "top20BrandsClickShareNow": 1,
                        "top20BrandsClickShareT90Before": 1,
                        "top20BrandsClickShareT360Before": 1,
                        "top20BrandsClickShareT360Now": 1,
                        "top20BrandsClickShareT360T90Before": 1,
                        "top20BrandsClickShareT360T360Before": 1,
                        "newProductsLaunchedSemiannual": 1,
                        "newProductsLaunchedT180Now": 1,
                        "newProductsLaunchedT180T90Before": 1,
                        "newProductsLaunchedT180T360Before": 1,
                        "newProductsLaunchedT360Now": 1,
                        "newProductsLaunchedT360T90Before": 1,
                        "newProductsLaunchedT360T360Before": 1,
                        "successfulLaunchedSemiannual": 1,
                        "launchRateSemiannual": 1,
                        "successfulLaunchesT90Now": 1,
                        "successfulLaunchesT90T90Before": 1,
                        "successfulLaunchesT90T360Before": 1,
                        "successfulLaunchesT180Now": 1,
                        "successfulLaunchesT180T90Before": 1,
                        "successfulLaunchesT180T360Before": 1,
                        "successfulLaunchesT360Now": 1,
                        "successfulLaunchesT360T90Before": 1,
                        "successfulLaunchesT360T360Before": 1,
                        "avgOOSRateNow": 1,
                        "avgOOSRateT90Before": 1,
                        "avgOOSRateT360Before": 1,
                        "avgOOSRateT360Now": 1,
                        "avgOOSRateT360T90Before": 1,
                        "avgOOSRateT360T360Before": 1,
                        "primeProductsPercentageNow": 1,
                        "primeProductsPercentageT90Before": 1,
                        "primeProductsPercentageT360Before": 1,
                        "primeProductsPercentageT360Now": 1,
                        "primeProductsPercentageT360T90Before": 1,
                        "primeProductsPercentageT360T360Before": 1,
                        "avgReviewRatingNow": 1,
                        "avgReviewRatingT90Before": 1,
                        "avgReviewRatingT360Before": 1,
                        "avgReviewCountNow": 1,
                        "avgReviewCountT90Before": 1,
                        "avgReviewCountT360Before": 1,
                        "positiveCustomerReviewInsights": [],
                        "negativeCustomerReviewInsights": [],
                        "productStarRatingImpact": [],
                        "avgBrandAgeNow": 1,
                        "avgBrandAgeT90Before": 1,
                        "avgBrandAgeT360Before": 1,
                        "avgBrandAgeQuarterly": 1,
                        "avgBrandAgeT360Now": 1,
                        "avgBrandAgeT360T90Before": 1,
                        "avgBrandAgeT360T360Before": 1,
                        "avgSellingPartnerAgeNow": 1,
                        "avgSellingPartnerAgeT90Before": 1,
                        "avgSellingPartnerAgeT360Before": 1,
                        "avgBestSellerRankNow": 1,
                        "avgBestSellerRankT90Before": 1,
                        "avgBestSellerRankT360Before": 1,
                        "acos": 1,
                        "sponsoredProductsPercentageNow": 1,
                        "sponsoredProductsPercentageT90Before": 1,
                        "sponsoredProductsPercentageT360Before": 1,
                        "sponsoredProductsPercentageT360Now": 1,
                        "sponsoredProductsPercentageT360T90Before": 1,
                        "sponsoredProductsPercentageT360T360Before": 1,
                        "profitMarginGt50PctSkuRatio": 1,
                        "breakEvenRatio": 1,
                        "returnRateAnnual": 1,
                        "cpc": {}
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-niche-info",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_niche_info",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-niche-info-by-asin/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Niche Info By Asin",
        "description": "Deep analysis of Amazon niche markets by product ASIN, covering monopoly level, brand concentration, new product success rate, and market opportunity score. Trigger when the user mentions niche market analysis by ASIN, ASIN market research, ASIN niche lookup, monopoly assessment, brand concentration analysis, new product success rate, market demand score, competitive landscape, Amazon sub-market exploration, ASIN niche analysis, niche by ASIN, monopoly level, brand concentration, new product success rate, market opportunity score, competitive landscape, Nexscope data. Even if the user does not explicitly mention \"niche market\" or \"ASIN\", if their need involves evaluating the competitive landscape, brand density, or opportunity potential of the niche segment a specific product ASIN belongs to, this skill should also be triggered.",
        "operationId": "runAmazonNicheInfoByAsin",
        "externalDocs": {
          "description": "Amazon Niche Info By Asin documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-niche-info-by-asin"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-niche-info-by-asin.",
                "properties": {
                  "asin": {
                    "type": "string",
                    "description": "Product ASIN (required). The tool will find market segments that share the same niche as this ASIN",
                    "example": "B072MQ5BRX"
                  },
                  "countryCode": {
                    "type": "string",
                    "description": "Country code, options: US (United States), JP (Japan), DE (Germany)"
                  },
                  "count": {
                    "type": "integer",
                    "description": "Number of niche markets returned",
                    "example": 1
                  },
                  "productCountMin": {
                    "type": "integer",
                    "description": "Minimum product count (current)",
                    "example": 1
                  },
                  "productCountMax": {
                    "type": "integer",
                    "description": "Maximum product count (current)",
                    "example": 1
                  },
                  "avgPriceMin": {
                    "type": "number",
                    "description": "Minimum average price (current)",
                    "example": 1
                  },
                  "avgPriceMax": {
                    "type": "number",
                    "description": "Maximum average price (current)",
                    "example": 1
                  },
                  "searchVolumeT7Min": {
                    "type": "integer",
                    "description": "Minimum search volume (7-day stats)",
                    "example": 1
                  },
                  "searchVolumeT7Max": {
                    "type": "integer",
                    "description": "Maximum search volume (7-day stats)",
                    "example": 1
                  },
                  "unitsSoldT7Min": {
                    "type": "integer",
                    "description": "Minimum sales volume (7-day stats)",
                    "example": 1
                  },
                  "unitsSoldT7Max": {
                    "type": "integer",
                    "description": "Maximum sales volume (7-day stats)",
                    "example": 1
                  },
                  "clickCountT7Min": {
                    "type": "integer",
                    "description": "Minimum click volume (7-day stats)",
                    "example": 1
                  },
                  "clickCountT7Max": {
                    "type": "integer",
                    "description": "Maximum click volume (7-day stats)",
                    "example": 1
                  },
                  "clickConversionRateT7Min": {
                    "type": "number",
                    "description": "Minimum click conversion rate (7-day stats), range 0-1, 0.1 means 10% conversion rate",
                    "example": 1
                  },
                  "clickConversionRateT7Max": {
                    "type": "number",
                    "description": "Maximum click conversion rate (7-day stats), range 0-1, 0.1 means 10% conversion rate",
                    "example": 1
                  },
                  "brandCountMin": {
                    "type": "integer",
                    "description": "Minimum brand count",
                    "example": 1
                  },
                  "brandCountMax": {
                    "type": "integer",
                    "description": "Maximum brand count",
                    "example": 1
                  },
                  "top5BrandsClickShareMin": {
                    "type": "number",
                    "description": "Minimum top 5 brands' click share in the niche market, range 0-1, 0.1 means 10% click share",
                    "example": 1
                  },
                  "top5BrandsClickShareMax": {
                    "type": "number",
                    "description": "Maximum top 5 brands' click share in the niche market, range 0-1, 0.1 means 10% click share",
                    "example": 1
                  },
                  "avgBrandAgeMin": {
                    "type": "number",
                    "description": "Minimum average brand age (current)",
                    "example": 1
                  },
                  "avgBrandAgeMax": {
                    "type": "number",
                    "description": "Maximum average brand age (current)",
                    "example": 1
                  },
                  "avgBrandAgeQoqMin": {
                    "type": "number",
                    "description": "Minimum average brand age (90-day stats)",
                    "example": 1
                  },
                  "avgBrandAgeQoqMax": {
                    "type": "number",
                    "description": "Maximum average brand age (90-day stats)",
                    "example": 1
                  },
                  "avgBrandAgeYoyMin": {
                    "type": "number",
                    "description": "Minimum average brand age (360-day stats)",
                    "example": 1
                  },
                  "avgBrandAgeYoyMax": {
                    "type": "number",
                    "description": "Maximum average brand age (360-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeMin": {
                    "type": "number",
                    "description": "Minimum average selling partner age",
                    "example": 1
                  },
                  "avgSellingPartnerAgeMax": {
                    "type": "number",
                    "description": "Maximum average selling partner age",
                    "example": 1
                  },
                  "avgSellingPartnerAgeQoqMin": {
                    "type": "number",
                    "description": "Minimum average selling partner age (90-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeQoqMax": {
                    "type": "number",
                    "description": "Maximum average selling partner age (90-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeYoyMin": {
                    "type": "number",
                    "description": "Minimum average selling partner age (360-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeYoyMax": {
                    "type": "number",
                    "description": "Maximum average selling partner age (360-day stats)",
                    "example": 1
                  },
                  "top5ProductsClickShareMin": {
                    "type": "number",
                    "description": "Minimum top 5 products click share (current), range 0-1, 0.1 means 10% click share",
                    "example": 1
                  },
                  "top5ProductsClickShareMax": {
                    "type": "number",
                    "description": "Maximum top 5 products click share (current), range 0-1, 0.1 means 10% click share",
                    "example": 1
                  },
                  "sponsoredProductsPercentageMin": {
                    "type": "number",
                    "description": "Minimum SP ad share, range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "sponsoredProductsPercentageMax": {
                    "type": "number",
                    "description": "Maximum SP ad share, range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "cpcMediumMin": {
                    "type": "number",
                    "description": "Minimum CPC (current)",
                    "example": 1
                  },
                  "cpcMediumMax": {
                    "type": "number",
                    "description": "Maximum CPC (current)",
                    "example": 1
                  },
                  "launchRateT180Min": {
                    "type": "number",
                    "description": "Minimum product launch success rate (180-day stats), range 0-1, 0.1 means 10% success rate",
                    "example": 1
                  },
                  "launchRateT180Max": {
                    "type": "number",
                    "description": "Maximum product launch success rate (180-day stats), range 0-1, 0.1 means 10% success rate",
                    "example": 1
                  },
                  "returnRateT360Min": {
                    "type": "number",
                    "description": "Minimum return rate (360-day stats), range 0-1, 0.1 means 10% return rate",
                    "example": 1
                  },
                  "returnRateT360Max": {
                    "type": "number",
                    "description": "Maximum return rate (360-day stats), range 0-1, 0.1 means 10% return rate",
                    "example": 1
                  }
                },
                "required": [
                  "asin"
                ],
                "example": {
                  "countryCode": "US",
                  "count": 10,
                  "asin": "B072MQ5BRX"
                },
                "additionalProperties": true
              },
              "example": {
                "countryCode": "US",
                "count": 10,
                "asin": "B072MQ5BRX"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "nicheInfoVoList": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Niche market information list (see niche market object fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nicheId": {
                                        "type": "string",
                                        "description": "Niche market ID",
                                        "example": "example-id"
                                      },
                                      "nicheTitle": {
                                        "type": "string",
                                        "description": "Niche market title",
                                        "example": null
                                      },
                                      "translationZh": {
                                        "type": "string",
                                        "description": "Niche market title (Chinese)",
                                        "example": null
                                      },
                                      "demand": {
                                        "type": "integer",
                                        "description": "Niche market score",
                                        "example": 1
                                      },
                                      "productCount": {
                                        "type": "integer",
                                        "description": "Product count",
                                        "example": 1
                                      },
                                      "avgPrice": {
                                        "type": "number",
                                        "description": "Average product price",
                                        "example": 1
                                      },
                                      "minimumPrice": {
                                        "type": "number",
                                        "description": "Lowest product price",
                                        "example": 1
                                      },
                                      "maximumPrice": {
                                        "type": "number",
                                        "description": "Highest product price",
                                        "example": 1
                                      },
                                      "searchVolumeWeekly": {
                                        "type": "integer",
                                        "description": "Search volume (weekly data)",
                                        "example": 1
                                      },
                                      "searchVolumeQuarterly": {
                                        "type": "integer",
                                        "description": "Search volume (quarterly data)",
                                        "example": 1
                                      },
                                      "searchVolumeGrowthWeekly": {
                                        "type": "number",
                                        "description": "Search volume growth rate (weekly data)",
                                        "example": 1
                                      },
                                      "searchVolumeGrowthQuarterly": {
                                        "type": "number",
                                        "description": "Search volume growth rate (quarterly data)",
                                        "example": 1
                                      },
                                      "unitsSoldWeekly": {
                                        "type": "integer",
                                        "description": "Sales volume (weekly data)",
                                        "example": 1
                                      },
                                      "unitsSoldQuarterly": {
                                        "type": "integer",
                                        "description": "Sales volume (quarterly data)",
                                        "example": 1
                                      },
                                      "clickCountWeekly": {
                                        "type": "integer",
                                        "description": "Click volume (weekly data)",
                                        "example": 1
                                      },
                                      "clickCountQuarterly": {
                                        "type": "integer",
                                        "description": "Click volume (quarterly data)",
                                        "example": 1
                                      },
                                      "clickToSaleConversionWeekly": {
                                        "type": "number",
                                        "description": "Click conversion rate (weekly data)",
                                        "example": 1
                                      },
                                      "clickConversionRateQuarterly": {
                                        "type": "number",
                                        "description": "Click conversion rate (quarterly data)",
                                        "example": 1
                                      },
                                      "searchConversionRateWeekly": {
                                        "type": "number",
                                        "description": "Search conversion rate (weekly data)",
                                        "example": 1
                                      },
                                      "searchConversionRateQuarterly": {
                                        "type": "number",
                                        "description": "Search conversion rate (quarterly data)",
                                        "example": 1
                                      },
                                      "brandCount": {
                                        "type": "integer",
                                        "description": "Brand count",
                                        "example": 1
                                      },
                                      "top5BrandsClickShare": {
                                        "type": "number",
                                        "description": "Top 5 brands' click share in the niche market",
                                        "example": 1
                                      },
                                      "top5ProductsClickShare": {
                                        "type": "number",
                                        "description": "Top 5 products click share",
                                        "example": 1
                                      },
                                      "avgBrandAgeNow": {
                                        "type": "number",
                                        "description": "Average brand age (current)",
                                        "example": 1
                                      },
                                      "avgBrandAgeQuarterly": {
                                        "type": "number",
                                        "description": "Average brand age (quarterly data)",
                                        "example": 1
                                      },
                                      "newProductsLaunchedSemiannual": {
                                        "type": "integer",
                                        "description": "Number of new products launched (semi-annual data)",
                                        "example": 1
                                      },
                                      "successfulLaunchedSemiannual": {
                                        "type": "integer",
                                        "description": "Number of successfully launched products (semi-annual data)",
                                        "example": 1
                                      },
                                      "launchRateSemiannual": {
                                        "type": "number",
                                        "description": "Product launch success rate (semi-annual data)",
                                        "example": 1
                                      },
                                      "returnRateAnnual": {
                                        "type": "number",
                                        "description": "Return rate (annual data)",
                                        "example": 1
                                      },
                                      "acos": {
                                        "type": "number",
                                        "description": "(ACOS) Advertising Cost of Sale",
                                        "example": 1
                                      },
                                      "profitMarginGt50PctSkuRatio": {
                                        "type": "number",
                                        "description": "Proportion of products with profit margin > 50%",
                                        "example": 1
                                      },
                                      "breakEvenRatio": {
                                        "type": "number",
                                        "description": "Break-even natural share",
                                        "example": 1
                                      },
                                      "cpc": {
                                        "type": "object",
                                        "description": "CPC data: { high (maximum bid), medium (median bid), low (minimum bid) }",
                                        "example": {}
                                      },
                                      "categorieList": {
                                        "type": "array",
                                        "description": "Product category list",
                                        "example": []
                                      },
                                      "referenceAsinImageUrl": {
                                        "type": "string",
                                        "description": "Niche market reference image URL",
                                        "example": "B072MQ5BRX"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "costToken": 1,
                    "nicheInfoVoList": [
                      {
                        "nicheId": "example-id",
                        "demand": 1,
                        "productCount": 1,
                        "avgPrice": 1,
                        "minimumPrice": 1,
                        "maximumPrice": 1,
                        "searchVolumeWeekly": 1,
                        "searchVolumeQuarterly": 1,
                        "searchVolumeGrowthWeekly": 1,
                        "searchVolumeGrowthQuarterly": 1,
                        "unitsSoldWeekly": 1,
                        "unitsSoldQuarterly": 1,
                        "clickCountWeekly": 1,
                        "clickCountQuarterly": 1,
                        "clickToSaleConversionWeekly": 1,
                        "clickConversionRateQuarterly": 1,
                        "searchConversionRateWeekly": 1,
                        "searchConversionRateQuarterly": 1,
                        "brandCount": 1,
                        "top5BrandsClickShare": 1,
                        "top5ProductsClickShare": 1,
                        "avgBrandAgeNow": 1,
                        "avgBrandAgeQuarterly": 1,
                        "newProductsLaunchedSemiannual": 1,
                        "successfulLaunchedSemiannual": 1,
                        "launchRateSemiannual": 1,
                        "returnRateAnnual": 1,
                        "acos": 1,
                        "profitMarginGt50PctSkuRatio": 1,
                        "breakEvenRatio": 1,
                        "cpc": {},
                        "categorieList": [],
                        "referenceAsinImageUrl": "B072MQ5BRX"
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-niche-info-by-asin",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_niche_info_by_asin",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-niche-info-by-keyword/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Niche Info By Keyword",
        "description": "Deep analysis of Amazon niche markets by keyword, covering monopoly level, brand concentration, new product success rate, and market opportunity score. Trigger when the user mentions niche market analysis, keyword market research, monopoly assessment, brand concentration analysis, new product success rate, market demand score, competitive landscape, Amazon sub-market exploration, niche market analysis, keyword market, monopoly level, brand concentration, new product success rate, market opportunity score, competitive landscape, Nexscope data. Even if the user does not explicitly mention \"niche market\", if their need involves evaluating the competitive landscape, brand density, or opportunity potential of the Amazon market at the keyword dimension level, this skill should also be triggered.",
        "operationId": "runAmazonNicheInfoByKeyword",
        "externalDocs": {
          "description": "Amazon Niche Info By Keyword documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-niche-info-by-keyword"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-niche-info-by-keyword.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Keyword (required, translate the keyword to the corresponding country's language based on the selected country), max length 1000 characters",
                    "example": "phone case"
                  },
                  "countryCode": {
                    "type": "string",
                    "description": "Country code, options: US (United States), JP (Japan), DE (Germany)"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page (10-100)",
                    "example": 10
                  },
                  "sortField": {
                    "type": "string",
                    "description": "Sort field (see sort options below)"
                  },
                  "sortType": {
                    "type": "string",
                    "description": "Sort direction: desc (descending) or asc (ascending)"
                  },
                  "productCountMin": {
                    "type": "integer",
                    "description": "Minimum product count (current)",
                    "example": 1
                  },
                  "productCountMax": {
                    "type": "integer",
                    "description": "Maximum product count (current)",
                    "example": 1
                  },
                  "avgPriceMin": {
                    "type": "number",
                    "description": "Minimum average price (current)",
                    "example": 1
                  },
                  "avgPriceMax": {
                    "type": "number",
                    "description": "Maximum average price (current)",
                    "example": 1
                  },
                  "searchVolumeT7Min": {
                    "type": "integer",
                    "description": "Minimum search volume (7-day stats)",
                    "example": 1
                  },
                  "searchVolumeT7Max": {
                    "type": "integer",
                    "description": "Maximum search volume (7-day stats)",
                    "example": 1
                  },
                  "unitsSoldT7Min": {
                    "type": "integer",
                    "description": "Minimum sales volume (7-day stats)",
                    "example": 1
                  },
                  "unitsSoldT7Max": {
                    "type": "integer",
                    "description": "Maximum sales volume (7-day stats)",
                    "example": 1
                  },
                  "clickCountT7Min": {
                    "type": "integer",
                    "description": "Minimum click volume (7-day stats)",
                    "example": 1
                  },
                  "clickCountT7Max": {
                    "type": "integer",
                    "description": "Maximum click volume (7-day stats)",
                    "example": 1
                  },
                  "clickConversionRateT7Min": {
                    "type": "number",
                    "description": "Minimum click conversion rate (7-day stats), range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "clickConversionRateT7Max": {
                    "type": "number",
                    "description": "Maximum click conversion rate (7-day stats), range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "brandCountMin": {
                    "type": "integer",
                    "description": "Minimum brand count",
                    "example": 1
                  },
                  "brandCountMax": {
                    "type": "integer",
                    "description": "Maximum brand count",
                    "example": 1
                  },
                  "top5BrandsClickShareMin": {
                    "type": "number",
                    "description": "Minimum top 5 brands' click share in the niche market, range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "top5BrandsClickShareMax": {
                    "type": "number",
                    "description": "Maximum top 5 brands' click share in the niche market, range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "avgBrandAgeMin": {
                    "type": "number",
                    "description": "Minimum average brand age (current)",
                    "example": 1
                  },
                  "avgBrandAgeMax": {
                    "type": "number",
                    "description": "Maximum average brand age (current)",
                    "example": 1
                  },
                  "avgBrandAgeQoqMin": {
                    "type": "number",
                    "description": "Minimum average brand age (90-day stats)",
                    "example": 1
                  },
                  "avgBrandAgeQoqMax": {
                    "type": "number",
                    "description": "Maximum average brand age (90-day stats)",
                    "example": 1
                  },
                  "avgBrandAgeYoyMin": {
                    "type": "number",
                    "description": "Minimum average brand age (360-day stats)",
                    "example": 1
                  },
                  "avgBrandAgeYoyMax": {
                    "type": "number",
                    "description": "Maximum average brand age (360-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeMin": {
                    "type": "number",
                    "description": "Minimum average selling partner age",
                    "example": 1
                  },
                  "avgSellingPartnerAgeMax": {
                    "type": "number",
                    "description": "Maximum average selling partner age",
                    "example": 1
                  },
                  "avgSellingPartnerAgeQoqMin": {
                    "type": "number",
                    "description": "Minimum average selling partner age (90-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeQoqMax": {
                    "type": "number",
                    "description": "Maximum average selling partner age (90-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeYoyMin": {
                    "type": "number",
                    "description": "Minimum average selling partner age (360-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeYoyMax": {
                    "type": "number",
                    "description": "Maximum average selling partner age (360-day stats)",
                    "example": 1
                  },
                  "top5ProductsClickShareMin": {
                    "type": "number",
                    "description": "Minimum top 5 products click share (current), range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "top5ProductsClickShareMax": {
                    "type": "number",
                    "description": "Maximum top 5 products click share (current), range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "sponsoredProductsPercentageMin": {
                    "type": "number",
                    "description": "Minimum SP ad share, range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "sponsoredProductsPercentageMax": {
                    "type": "number",
                    "description": "Maximum SP ad share, range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "cpcMediumMin": {
                    "type": "number",
                    "description": "Minimum CPC (current)",
                    "example": 1
                  },
                  "cpcMediumMax": {
                    "type": "number",
                    "description": "Maximum CPC (current)",
                    "example": 1
                  },
                  "launchRateT180Min": {
                    "type": "number",
                    "description": "Minimum product launch success rate (180-day stats), range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "launchRateT180Max": {
                    "type": "number",
                    "description": "Maximum product launch success rate (180-day stats), range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "newProductRateT180": {
                    "type": "number",
                    "description": "Minimum new product share (180-day stats), range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "returnRateT360Min": {
                    "type": "number",
                    "description": "Minimum return rate (360-day stats), range 0-1, representing 0%-100%",
                    "example": 1
                  },
                  "returnRateT360Max": {
                    "type": "number",
                    "description": "Maximum return rate (360-day stats), range 0-1, representing 0%-100%",
                    "example": 1
                  }
                },
                "required": [
                  "keyword"
                ],
                "example": {
                  "page": 1,
                  "countryCode": "US",
                  "keyword": "phone case",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "countryCode": "US",
                "keyword": "phone case",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Niche market information list (see niche market object fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nicheId": {
                                        "type": "string",
                                        "description": "Niche market ID",
                                        "example": "example-id"
                                      },
                                      "nicheTitle": {
                                        "type": "string",
                                        "description": "Niche market title",
                                        "example": null
                                      },
                                      "translationZh": {
                                        "type": "string",
                                        "description": "Niche market title (Chinese)",
                                        "example": null
                                      },
                                      "demand": {
                                        "type": "integer",
                                        "description": "Niche market score",
                                        "example": 1
                                      },
                                      "productCount": {
                                        "type": "integer",
                                        "description": "Product count",
                                        "example": 1
                                      },
                                      "avgPrice": {
                                        "type": "number",
                                        "description": "Average product price",
                                        "example": 1
                                      },
                                      "minimumPrice": {
                                        "type": "number",
                                        "description": "Lowest product price",
                                        "example": 1
                                      },
                                      "maximumPrice": {
                                        "type": "number",
                                        "description": "Highest product price",
                                        "example": 1
                                      },
                                      "searchVolumeWeekly": {
                                        "type": "integer",
                                        "description": "Search volume (weekly data)",
                                        "example": 1
                                      },
                                      "searchVolumeQuarterly": {
                                        "type": "integer",
                                        "description": "Search volume (quarterly data)",
                                        "example": 1
                                      },
                                      "searchVolumeGrowthWeekly": {
                                        "type": "number",
                                        "description": "Search volume growth rate (weekly data)",
                                        "example": 1
                                      },
                                      "searchVolumeGrowthQuarterly": {
                                        "type": "number",
                                        "description": "Search volume growth rate (quarterly data)",
                                        "example": 1
                                      },
                                      "unitsSoldWeekly": {
                                        "type": "integer",
                                        "description": "Sales volume (weekly data)",
                                        "example": 1
                                      },
                                      "unitsSoldQuarterly": {
                                        "type": "integer",
                                        "description": "Sales volume (quarterly data)",
                                        "example": 1
                                      },
                                      "clickCountWeekly": {
                                        "type": "integer",
                                        "description": "Click volume (weekly data)",
                                        "example": 1
                                      },
                                      "clickCountQuarterly": {
                                        "type": "integer",
                                        "description": "Click volume (quarterly data)",
                                        "example": 1
                                      },
                                      "clickToSaleConversionWeekly": {
                                        "type": "number",
                                        "description": "Click conversion rate (weekly data)",
                                        "example": 1
                                      },
                                      "clickConversionRateQuarterly": {
                                        "type": "number",
                                        "description": "Click conversion rate (quarterly data)",
                                        "example": 1
                                      },
                                      "searchConversionRateWeekly": {
                                        "type": "number",
                                        "description": "Search conversion rate (weekly data)",
                                        "example": 1
                                      },
                                      "searchConversionRateQuarterly": {
                                        "type": "number",
                                        "description": "Search conversion rate (quarterly data)",
                                        "example": 1
                                      },
                                      "brandCount": {
                                        "type": "integer",
                                        "description": "Brand count",
                                        "example": 1
                                      },
                                      "top5BrandsClickShare": {
                                        "type": "number",
                                        "description": "Top 5 brands' click share in the niche market",
                                        "example": 1
                                      },
                                      "top5ProductsClickShare": {
                                        "type": "number",
                                        "description": "Top 5 products click share",
                                        "example": 1
                                      },
                                      "avgBrandAgeNow": {
                                        "type": "number",
                                        "description": "Average brand age (current)",
                                        "example": 1
                                      },
                                      "avgBrandAgeQuarterly": {
                                        "type": "number",
                                        "description": "Average brand age (quarterly data)",
                                        "example": 1
                                      },
                                      "newProductsLaunchedSemiannual": {
                                        "type": "integer",
                                        "description": "Number of new products launched (semi-annual data)",
                                        "example": 1
                                      },
                                      "successfulLaunchedSemiannual": {
                                        "type": "integer",
                                        "description": "Number of successfully launched products (semi-annual data)",
                                        "example": 1
                                      },
                                      "launchRateSemiannual": {
                                        "type": "number",
                                        "description": "Product launch success rate (semi-annual data)",
                                        "example": 1
                                      },
                                      "returnRateAnnual": {
                                        "type": "number",
                                        "description": "Return rate (annual data)",
                                        "example": 1
                                      },
                                      "acos": {
                                        "type": "number",
                                        "description": "(ACOS) Advertising Cost of Sale",
                                        "example": 1
                                      },
                                      "profitMarginGt50PctSkuRatio": {
                                        "type": "number",
                                        "description": "Proportion of products with profit margin > 50%",
                                        "example": 1
                                      },
                                      "breakEvenRatio": {
                                        "type": "number",
                                        "description": "Break-even ratio",
                                        "example": 1
                                      },
                                      "cpc": {
                                        "type": "object",
                                        "description": "CPC data: { high (maximum bid), medium (median bid), low (minimum bid) }",
                                        "example": {}
                                      },
                                      "categorieList": {
                                        "type": "array",
                                        "description": "Product category list",
                                        "example": []
                                      },
                                      "referenceAsinImageUrl": {
                                        "type": "string",
                                        "description": "Niche market reference image URL",
                                        "example": "B072MQ5BRX"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "nicheId": "example-id",
                        "demand": 1,
                        "productCount": 1,
                        "avgPrice": 1,
                        "minimumPrice": 1,
                        "maximumPrice": 1,
                        "searchVolumeWeekly": 1,
                        "searchVolumeQuarterly": 1,
                        "searchVolumeGrowthWeekly": 1,
                        "searchVolumeGrowthQuarterly": 1,
                        "unitsSoldWeekly": 1,
                        "unitsSoldQuarterly": 1,
                        "clickCountWeekly": 1,
                        "clickCountQuarterly": 1,
                        "clickToSaleConversionWeekly": 1,
                        "clickConversionRateQuarterly": 1,
                        "searchConversionRateWeekly": 1,
                        "searchConversionRateQuarterly": 1,
                        "brandCount": 1,
                        "top5BrandsClickShare": 1,
                        "top5ProductsClickShare": 1,
                        "avgBrandAgeNow": 1,
                        "avgBrandAgeQuarterly": 1,
                        "newProductsLaunchedSemiannual": 1,
                        "successfulLaunchedSemiannual": 1,
                        "launchRateSemiannual": 1,
                        "returnRateAnnual": 1,
                        "acos": 1,
                        "profitMarginGt50PctSkuRatio": 1,
                        "breakEvenRatio": 1,
                        "cpc": {},
                        "categorieList": [],
                        "referenceAsinImageUrl": "B072MQ5BRX"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-niche-info-by-keyword",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_niche_info_by_keyword",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Niche Reviews By Keyword",
        "description": "Amazon niche market review analysis and consumer sentiment insights. Trigger when the user mentions niche market review analysis, consumer sentiment, user pain points, customer feedback insights, review topic analysis, positive/negative review breakdown, niche market opinion mining, product review sentiment analysis, niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Nexscope data. Even if the user does not explicitly mention \"niche market reviews\", if their need involves analyzing consumer reviews within Amazon niche markets or understanding customer sentiment at the niche market level, this skill should also be triggered.",
        "operationId": "runAmazonNicheReviewsByKeyword",
        "externalDocs": {
          "description": "Amazon Niche Reviews By Keyword documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-niche-reviews-by-keyword"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-niche-reviews-by-keyword.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Keyword (required, use the language of the corresponding site, e.g. English for the US site, German for the Germany site), max length 1000 characters",
                    "example": "phone case"
                  },
                  "countryCode": {
                    "type": "string",
                    "description": "Country code, options: US (United States), JP (Japan), DE (Germany)"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page (10-100)",
                    "example": 10
                  },
                  "sortField": {
                    "type": "string",
                    "description": "Sort field, options: clickConversionRateT7 (7-day click conversion rate), demand (demand score), avgPrice (average product price), maximumPrice (highest product price), minimumPrice (lowest product price), productCount (product count), searchConversionRateT7 (7-day search conversion rate), searchVolumeT7 (7-day search volume), unitsSoldT7 (7-day sales volume), searchVolumeGrowthT7 (search growth rate), clickCountT90 (90-day click volume), clickCountT7 (weekly click volume), brandCount (brand count), top5BrandsClickShare (TOP5 brand share), newProductsLaunchedT180 (180-day new product success rate - launch count), successfulLaunchesT180 (180-day new product success rate - new product count), launchRateT180 (180-day new product success rate - launch rate), top5ProductsClickShare (top 5 product click share), returnRateT360 (return rate), clickConversionRateT90 (90-day click conversion rate), searchConversionRateT90 (90-day search conversion rate), searchVolumeT90 (90-day search volume), unitsSoldT90 (90-day sales volume), unitsSoldGrowthT90 (90-day sales growth rate), searchVolumeGrowthT90 (90-day search growth rate), acos, profitRate50 (profit rate for 50% natural orders)"
                  },
                  "sortType": {
                    "type": "string",
                    "description": "Sort direction, options: desc (descending), asc (ascending)"
                  },
                  "productCountMin": {
                    "type": "integer",
                    "description": "Minimum product count (current)",
                    "example": 1
                  },
                  "productCountMax": {
                    "type": "integer",
                    "description": "Maximum product count (current)",
                    "example": 1
                  },
                  "brandCountMin": {
                    "type": "integer",
                    "description": "Minimum brand count",
                    "example": 1
                  },
                  "brandCountMax": {
                    "type": "integer",
                    "description": "Maximum brand count",
                    "example": 1
                  },
                  "avgPriceMin": {
                    "type": "number",
                    "description": "Minimum average price (current)",
                    "example": 1
                  },
                  "avgPriceMax": {
                    "type": "number",
                    "description": "Maximum average price (current)",
                    "example": 1
                  },
                  "unitsSoldT7Min": {
                    "type": "integer",
                    "description": "Minimum sales volume (7-day stats)",
                    "example": 1
                  },
                  "unitsSoldT7Max": {
                    "type": "integer",
                    "description": "Maximum sales volume (7-day stats)",
                    "example": 1
                  },
                  "searchVolumeT7Min": {
                    "type": "integer",
                    "description": "Minimum search volume (7-day stats)",
                    "example": 1
                  },
                  "searchVolumeT7Max": {
                    "type": "integer",
                    "description": "Maximum search volume (7-day stats)",
                    "example": 1
                  },
                  "clickCountT7Min": {
                    "type": "integer",
                    "description": "Minimum click volume (7-day stats)",
                    "example": 1
                  },
                  "clickCountT7Max": {
                    "type": "integer",
                    "description": "Maximum click volume (7-day stats)",
                    "example": 1
                  },
                  "clickConversionRateT7Min": {
                    "type": "number",
                    "description": "Minimum click conversion rate (7-day stats)",
                    "example": 1
                  },
                  "clickConversionRateT7Max": {
                    "type": "number",
                    "description": "Maximum click conversion rate (7-day stats)",
                    "example": 1
                  },
                  "top5BrandsClickShareMin": {
                    "type": "number",
                    "description": "Minimum top 5 brands' click share in the niche market",
                    "example": 1
                  },
                  "top5BrandsClickShareMax": {
                    "type": "number",
                    "description": "Maximum top 5 brands' click share in the niche market",
                    "example": 1
                  },
                  "top5ProductsClickShareMin": {
                    "type": "number",
                    "description": "Minimum top 5 products click share (current)",
                    "example": 1
                  },
                  "top5ProductsClickShareMax": {
                    "type": "number",
                    "description": "Maximum top 5 products click share (current)",
                    "example": 1
                  },
                  "sponsoredProductsPercentageMin": {
                    "type": "number",
                    "description": "Minimum SP ad share",
                    "example": 1
                  },
                  "sponsoredProductsPercentageMax": {
                    "type": "number",
                    "description": "Maximum SP ad share",
                    "example": 1
                  },
                  "avgBrandAgeMin": {
                    "type": "number",
                    "description": "Minimum average brand age (current)",
                    "example": 1
                  },
                  "avgBrandAgeMax": {
                    "type": "number",
                    "description": "Maximum average brand age (current)",
                    "example": 1
                  },
                  "avgBrandAgeQoqMin": {
                    "type": "number",
                    "description": "Minimum average brand age (90-day stats)",
                    "example": 1
                  },
                  "avgBrandAgeQoqMax": {
                    "type": "number",
                    "description": "Maximum average brand age (90-day stats)",
                    "example": 1
                  },
                  "avgBrandAgeYoyMin": {
                    "type": "number",
                    "description": "Minimum average brand age (360-day stats)",
                    "example": 1
                  },
                  "avgBrandAgeYoyMax": {
                    "type": "number",
                    "description": "Maximum average brand age (360-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeMin": {
                    "type": "number",
                    "description": "Minimum average selling partner age",
                    "example": 1
                  },
                  "avgSellingPartnerAgeMax": {
                    "type": "number",
                    "description": "Maximum average selling partner age",
                    "example": 1
                  },
                  "avgSellingPartnerAgeQoqMin": {
                    "type": "number",
                    "description": "Minimum average selling partner age (90-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeQoqMax": {
                    "type": "number",
                    "description": "Maximum average selling partner age (90-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeYoyMin": {
                    "type": "number",
                    "description": "Minimum average selling partner age (360-day stats)",
                    "example": 1
                  },
                  "avgSellingPartnerAgeYoyMax": {
                    "type": "number",
                    "description": "Maximum average selling partner age (360-day stats)",
                    "example": 1
                  },
                  "launchRateT180Min": {
                    "type": "number",
                    "description": "Minimum product launch success rate (180-day stats)",
                    "example": 1
                  },
                  "launchRateT180Max": {
                    "type": "number",
                    "description": "Maximum product launch success rate (180-day stats)",
                    "example": 1
                  },
                  "newProductRateT180": {
                    "type": "number",
                    "description": "Minimum new product share (180-day stats)",
                    "example": 1
                  },
                  "returnRateT360Min": {
                    "type": "number",
                    "description": "Minimum return rate (360-day stats)",
                    "example": 1
                  },
                  "returnRateT360Max": {
                    "type": "number",
                    "description": "Maximum return rate (360-day stats)",
                    "example": 1
                  },
                  "cpcMediumMin": {
                    "type": "number",
                    "description": "Minimum CPC (current)",
                    "example": 1
                  },
                  "cpcMediumMax": {
                    "type": "number",
                    "description": "Maximum CPC (current)",
                    "example": 1
                  }
                },
                "required": [
                  "keyword"
                ],
                "example": {
                  "page": 1,
                  "countryCode": "US",
                  "keyword": "phone case",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "countryCode": "US",
                "keyword": "phone case",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Niche market review list (see data item fields below for details)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nicheId": {
                                        "type": "string",
                                        "description": "Niche market ID",
                                        "example": "example-id"
                                      },
                                      "nicheName": {
                                        "type": "string",
                                        "description": "Niche market name",
                                        "example": null
                                      },
                                      "keyword": {
                                        "type": "string",
                                        "description": "Keyword",
                                        "example": "phone case"
                                      },
                                      "reviewType": {
                                        "type": "string",
                                        "description": "Review type (values: [Positive Reviews], [Negative Reviews])",
                                        "example": null
                                      },
                                      "topic": {
                                        "type": "string",
                                        "description": "Review topic",
                                        "example": null
                                      },
                                      "percentOfMentions": {
                                        "type": "number",
                                        "description": "Share (range 0-1, representing 0%-100%)",
                                        "example": 1
                                      },
                                      "reviewExample": {
                                        "type": "string",
                                        "description": "Review example",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "nicheId": "example-id",
                        "keyword": "phone case",
                        "percentOfMentions": 1
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-niche-reviews-by-keyword",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_niche_reviews_by_keyword",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-opportunity-report-by-keyword/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Opportunity Report By Keyword",
        "description": "Query Amazon business insight reports by keyword, covering six dimensions: market potential, product characteristics, user reviews, customer profiles, search trends, and pricing analysis with AI-powered comprehensive analysis. Trigger when users mention Amazon business insights, market opportunity reports, product selection reports, competitive landscape, consumer profiles, pricing analysis, niche market research, or similar terms. Even if the user does not explicitly say \"business insights,\" trigger this skill whenever their request involves a comprehensive market opportunity assessment or report generation for an Amazon keyword.",
        "operationId": "runAmazonOpportunityReportByKeyword",
        "externalDocs": {
          "description": "Amazon Opportunity Report By Keyword documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-opportunity-report-by-keyword"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-opportunity-report-by-keyword.",
                "properties": {
                  "site": {
                    "type": "string",
                    "description": "Amazon site code, currently only supports US",
                    "example": "US"
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Search keyword for the insight report",
                    "example": "phone case"
                  }
                },
                "required": [
                  "site",
                  "keyword"
                ],
                "example": {
                  "site": "US",
                  "keyword": "phone case"
                },
                "additionalProperties": true
              },
              "example": {
                "site": "US",
                "keyword": "phone case"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "stdout": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Comprehensive business insight report content (Markdown format), covering six dimensions: market potential, product features, user reviews, customer profiles, search trends, and pricing analysis",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total processing time (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-opportunity-report-by-keyword",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_opportunity_report_by_keyword",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-opportunity-search-by-metrics/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Opportunity Search By Metrics",
        "description": "Amazon reverse product selection: filter Amazon niches and keywords by 30+ business dimensions (market size & growth, price tiers & share, competition density & top concentration, demographics such as age/gender/income, review highlights & pain points) from a metrics pool aggregated from historical business insight reports. Trigger when users mention reverse product selection, metrics filtering, niche reverse lookup, blue ocean niche discovery, low-competition niche, newcomer-friendly niche, brand-fragmented market, pain-point entry, feature reverse lookup, pricing tier opportunity, demographic-based selection, or similar terms. Even if the user does not explicitly say \"reverse product selection,\" trigger this skill whenever the request involves filtering Amazon niches that match specific business criteria.",
        "operationId": "runAmazonOpportunitySearchByMetrics",
        "externalDocs": {
          "description": "Amazon Opportunity Search By Metrics documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-opportunity-search-by-metrics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-opportunity-search-by-metrics.",
                "properties": {
                  "amazonDomain": {
                    "type": "string",
                    "description": "Amazon site code (closed enum), currently only supports US. Defaults to US only if not specified"
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Maximum number of results to return (1-200), default 25. No page parameter; returns the most recent N records sorted by collection time descending",
                    "example": 1
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Search keyword text fragment (LIKE fuzzy match)",
                    "example": "phone case"
                  },
                  "nicheName": {
                    "type": "string",
                    "description": "Normalized niche name fragment (LIKE, snake_case lowercase), suitable for niche time-series comparison"
                  },
                  "nicheRevenue360dMinUsdAtLeastGte": {
                    "type": "number",
                    "description": "Minimum 360-day market revenue lower bound (USD)",
                    "example": 1
                  },
                  "nicheRevenue360dMinUsdAtLeastLte": {
                    "type": "number",
                    "description": "Maximum 360-day market revenue lower bound (USD)",
                    "example": 1
                  },
                  "nicheRevenue360dMaxUsdAtLeastGte": {
                    "type": "number",
                    "description": "Minimum 360-day market revenue upper bound (USD)",
                    "example": 1
                  },
                  "nicheRevenue360dMaxUsdAtLeastLte": {
                    "type": "number",
                    "description": "Maximum 360-day market revenue upper bound (USD)",
                    "example": 1
                  },
                  "nichePeakSearchVolumeAtLeastGte": {
                    "type": "integer",
                    "description": "Peak monthly search volume minimum (non-negative integer)",
                    "example": 1
                  },
                  "nichePeakSearchVolumeAtLeastLte": {
                    "type": "integer",
                    "description": "Peak monthly search volume maximum (non-negative integer)",
                    "example": 1
                  },
                  "nicheSearchVolumeYoyChangePctAtLeastGte": {
                    "type": "number",
                    "description": "Search volume YoY change rate minimum (%, signed)",
                    "example": 1
                  },
                  "nicheSearchVolumeYoyChangePctAtLeastLte": {
                    "type": "number",
                    "description": "Search volume YoY change rate maximum (%, signed)",
                    "example": 1
                  },
                  "nichePeakMonthGte": {
                    "type": "integer",
                    "description": "Search peak month minimum (1-12)",
                    "example": 1
                  },
                  "nichePeakMonthLte": {
                    "type": "integer",
                    "description": "Search peak month maximum (1-12)",
                    "example": 1
                  },
                  "nicheBrandCountGte": {
                    "type": "integer",
                    "description": "Active brand count minimum",
                    "example": 1
                  },
                  "nicheBrandCountLte": {
                    "type": "integer",
                    "description": "Active brand count maximum",
                    "example": 1
                  },
                  "nicheBrandCountYoyChangePctAtLeastGte": {
                    "type": "number",
                    "description": "Brand count YoY change rate minimum (%, signed)",
                    "example": 1
                  },
                  "nicheBrandCountYoyChangePctAtLeastLte": {
                    "type": "number",
                    "description": "Brand count YoY change rate maximum (%, signed)",
                    "example": 1
                  },
                  "nicheTop5ProductClickSharePctAtLeastGte": {
                    "type": "number",
                    "description": "Top 5 product click share minimum (0-100)",
                    "example": 1
                  },
                  "nicheTop5ProductClickSharePctAtLeastLte": {
                    "type": "number",
                    "description": "Top 5 product click share maximum (0-100)",
                    "example": 1
                  },
                  "featureTop5BrandSharePctAtLeastGte": {
                    "type": "number",
                    "description": "Top 5 brand combined share minimum (0-100)",
                    "example": 1
                  },
                  "featureTop5BrandSharePctAtLeastLte": {
                    "type": "number",
                    "description": "Top 5 brand combined share maximum (0-100)",
                    "example": 1
                  },
                  "featureTopBrandsContains": {
                    "type": "string",
                    "description": "Top 3 brand name fragment (original text LIKE, case-sensitive)"
                  },
                  "priceMinUsdGte": {
                    "type": "number",
                    "description": "Niche minimum product price lower bound (USD)",
                    "example": 1
                  },
                  "priceMinUsdLte": {
                    "type": "number",
                    "description": "Niche minimum product price upper bound (USD)",
                    "example": 1
                  },
                  "priceMaxUsdGte": {
                    "type": "number",
                    "description": "Niche maximum product price lower bound (USD)",
                    "example": 1
                  },
                  "priceMaxUsdLte": {
                    "type": "number",
                    "description": "Niche maximum product price upper bound (USD)",
                    "example": 1
                  },
                  "priceSweetSpotMinUsdGte": {
                    "type": "number",
                    "description": "Sweet spot lower bound minimum (USD)",
                    "example": 1
                  },
                  "priceSweetSpotMinUsdLte": {
                    "type": "number",
                    "description": "Sweet spot lower bound maximum (USD)",
                    "example": 1
                  },
                  "priceSweetSpotMaxUsdGte": {
                    "type": "number",
                    "description": "Sweet spot upper bound minimum (USD)",
                    "example": 1
                  },
                  "priceSweetSpotMaxUsdLte": {
                    "type": "number",
                    "description": "Sweet spot upper bound maximum (USD)",
                    "example": 1
                  },
                  "priceEntryClickSharePctAtLeastGte": {
                    "type": "number",
                    "description": "Entry tier click share minimum (0-100)",
                    "example": 1
                  },
                  "priceEntryClickSharePctAtLeastLte": {
                    "type": "number",
                    "description": "Entry tier click share maximum (0-100)",
                    "example": 1
                  },
                  "priceMidClickSharePctAtLeastGte": {
                    "type": "number",
                    "description": "Mid tier click share minimum (0-100)",
                    "example": 1
                  },
                  "priceMidClickSharePctAtLeastLte": {
                    "type": "number",
                    "description": "Mid tier click share maximum (0-100)",
                    "example": 1
                  },
                  "priceHighClickSharePctAtLeastGte": {
                    "type": "number",
                    "description": "High tier click share minimum (0-100)",
                    "example": 1
                  },
                  "priceHighClickSharePctAtLeastLte": {
                    "type": "number",
                    "description": "High tier click share maximum (0-100)",
                    "example": 1
                  },
                  "demoPrimaryAgeMinGte": {
                    "type": "integer",
                    "description": "Primary audience age lower bound minimum (0-120 years)",
                    "example": 1
                  },
                  "demoPrimaryAgeMinLte": {
                    "type": "integer",
                    "description": "Primary audience age lower bound maximum (0-120 years)",
                    "example": 1
                  },
                  "demoPrimaryAgeMaxGte": {
                    "type": "integer",
                    "description": "Primary audience age upper bound minimum (0-120 years)",
                    "example": 1
                  },
                  "demoPrimaryAgeMaxLte": {
                    "type": "integer",
                    "description": "Primary audience age upper bound maximum (0-120 years)",
                    "example": 1
                  },
                  "demoGenderDominant": {
                    "type": "string",
                    "description": "Dominant gender (closed enum): female / male / mixed / unspecified"
                  },
                  "demoPrimaryIncomeTier": {
                    "type": "string",
                    "description": "Income tier (closed enum): low / middle_low / middle / middle_upper / upper_middle / high"
                  },
                  "demoLifeStageTagsContains": {
                    "type": "string",
                    "description": "Life stage tag fragment (snake_case, LIKE): parent, student, retiree, athlete, etc."
                  },
                  "featureNewAvgReviewCountAtLeastGte": {
                    "type": "integer",
                    "description": "New product average review count minimum (non-negative integer)",
                    "example": 1
                  },
                  "featureNewAvgReviewCountAtLeastLte": {
                    "type": "integer",
                    "description": "New product average review count maximum (non-negative integer)",
                    "example": 1
                  },
                  "featureEstablishedAvgReviewCountAtLeastGte": {
                    "type": "integer",
                    "description": "Established product average review count minimum (non-negative integer)",
                    "example": 1
                  },
                  "featureEstablishedAvgReviewCountAtLeastLte": {
                    "type": "integer",
                    "description": "Established product average review count maximum (non-negative integer)",
                    "example": 1
                  },
                  "featureEmergingTrendTagsContains": {
                    "type": "string",
                    "description": "Emerging trend feature tag fragment (snake_case, LIKE): cordless, portable, smart, etc."
                  },
                  "featureUncommonFeatureTagsContains": {
                    "type": "string",
                    "description": "Rare differentiation feature tag fragment (snake_case, LIKE): hema_free, medical_grade_silicone, etc."
                  },
                  "searchTopCategory1Label": {
                    "type": "string",
                    "description": "Search traffic top category 1 label fragment (snake_case, LIKE): core_product_terms, set_kit_configurations, etc."
                  },
                  "reviewPositiveTop1Topic": {
                    "type": "string",
                    "description": "Positive review #1 topic fragment (snake_case, LIKE): comfort, quality_overall_generic, etc."
                  },
                  "reviewPositiveTop1PctAtLeastGte": {
                    "type": "number",
                    "description": "Positive review #1 topic share minimum (0-100, share among positive reviews)",
                    "example": 1
                  },
                  "reviewPositiveTop1PctAtLeastLte": {
                    "type": "number",
                    "description": "Positive review #1 topic share maximum (0-100)",
                    "example": 1
                  },
                  "reviewNegativeTop1Topic": {
                    "type": "string",
                    "description": "Negative review #1 topic fragment (snake_case, LIKE): size, quality, durability, etc."
                  },
                  "reviewNegativeTop1PctAtLeastGte": {
                    "type": "number",
                    "description": "Negative review #1 topic share minimum (0-100, share among negative reviews)",
                    "example": 1
                  },
                  "reviewNegativeTop1PctAtLeastLte": {
                    "type": "number",
                    "description": "Negative review #1 topic share maximum (0-100)",
                    "example": 1
                  },
                  "reviewNegativeTop2Topic": {
                    "type": "string",
                    "description": "Negative review #2 topic fragment (snake_case, LIKE)"
                  },
                  "reviewStrategicInsightTagsContains": {
                    "type": "string",
                    "description": "Review strategic insight tag fragment (snake_case, LIKE): sizing_clarity, material_transparency, etc."
                  }
                },
                "example": {
                  "limit": 10,
                  "keyword": "phone case",
                  "amazonDomain": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "limit": 10,
                "keyword": "phone case",
                "amazonDomain": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Array of keyword metric records, each corresponding to a (site, keyword) combination, approximately 37 fields, sorted by collection time descending",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "amazonDomain": {
                                        "type": "string",
                                        "description": "Site code (currently fixed US)",
                                        "example": null
                                      },
                                      "keyword": {
                                        "type": "string",
                                        "description": "Original search keyword",
                                        "example": "phone case"
                                      },
                                      "nicheName": {
                                        "type": "string",
                                        "description": "Normalized niche name (snake_case)",
                                        "example": null
                                      },
                                      "nicheRevenue360dMinUsdAtLeast": {
                                        "type": "number",
                                        "description": "Last 360 days market revenue lower bound / upper bound (USD)",
                                        "example": 1
                                      },
                                      "nicheRevenue360dMaxUsdAtLeast": {
                                        "type": "number",
                                        "description": "Last 360 days market revenue lower bound / upper bound (USD)",
                                        "example": 1
                                      },
                                      "nichePeakSearchVolumeAtLeast": {
                                        "type": "integer",
                                        "description": "Peak monthly search volume",
                                        "example": 1
                                      },
                                      "nichePeakMonth": {
                                        "type": "integer",
                                        "description": "Search peak month (1-12)",
                                        "example": 1
                                      },
                                      "nicheSearchVolumeYoyChangePctAtLeast": {
                                        "type": "number",
                                        "description": "Search volume YoY change rate (%, signed)",
                                        "example": 1
                                      },
                                      "nicheBrandCount": {
                                        "type": "integer",
                                        "description": "Active brand count and its YoY change rate",
                                        "example": 1
                                      },
                                      "nicheBrandCountYoyChangePctAtLeast": {
                                        "type": "number",
                                        "description": "Active brand count YoY change rate",
                                        "example": 1
                                      },
                                      "nicheTop5ProductClickSharePctAtLeast": {
                                        "type": "number",
                                        "description": "Top 5 product click share (0-100)",
                                        "example": 1
                                      },
                                      "featureTop5BrandSharePctAtLeast": {
                                        "type": "number",
                                        "description": "Top 5 brand combined share (0-100)",
                                        "example": 1
                                      },
                                      "featureTopBrands": {
                                        "type": "array",
                                        "description": "Top 3 brand name list (original text)",
                                        "example": []
                                      },
                                      "priceMinUsd": {
                                        "type": "number",
                                        "description": "Niche overall minimum / maximum product price",
                                        "example": 1
                                      },
                                      "priceMaxUsd": {
                                        "type": "number",
                                        "description": "Niche overall minimum / maximum product price",
                                        "example": 1
                                      },
                                      "priceSweetSpotMinUsd": {
                                        "type": "number",
                                        "description": "Value sweet spot price range lower bound / upper bound",
                                        "example": 1
                                      },
                                      "priceSweetSpotMaxUsd": {
                                        "type": "number",
                                        "description": "Value sweet spot price range lower bound / upper bound",
                                        "example": 1
                                      },
                                      "priceEntryClickSharePctAtLeast": {
                                        "type": "number",
                                        "description": "Entry / Mid / High tier click share (0-100)",
                                        "example": 1
                                      },
                                      "priceMidClickSharePctAtLeast": {
                                        "type": "number",
                                        "description": "Entry / Mid / High tier click share (0-100)",
                                        "example": 1
                                      },
                                      "priceHighClickSharePctAtLeast": {
                                        "type": "number",
                                        "description": "Entry / Mid / High tier click share (0-100)",
                                        "example": 1
                                      },
                                      "demoPrimaryAgeMin": {
                                        "type": "integer",
                                        "description": "Core audience age lower bound / upper bound",
                                        "example": 1
                                      },
                                      "demoPrimaryAgeMax": {
                                        "type": "integer",
                                        "description": "Core audience age lower bound / upper bound",
                                        "example": 1
                                      },
                                      "demoGenderDominant": {
                                        "type": "string",
                                        "description": "Dominant gender (female / male / mixed / unspecified)",
                                        "example": null
                                      },
                                      "demoPrimaryIncomeTier": {
                                        "type": "string",
                                        "description": "Core audience income tier",
                                        "example": null
                                      },
                                      "demoLifeStageTags": {
                                        "type": "array",
                                        "description": "Life stage tag list",
                                        "example": []
                                      },
                                      "featureNewAvgReviewCountAtLeast": {
                                        "type": "integer",
                                        "description": "New / Established product average review count",
                                        "example": 1
                                      },
                                      "featureEstablishedAvgReviewCountAtLeast": {
                                        "type": "integer",
                                        "description": "New / Established product average review count",
                                        "example": 1
                                      },
                                      "featureEmergingTrendTags": {
                                        "type": "array",
                                        "description": "Emerging trend / Rare differentiation feature tags",
                                        "example": []
                                      },
                                      "featureUncommonFeatureTags": {
                                        "type": "array",
                                        "description": "Emerging trend / Rare differentiation feature tags",
                                        "example": []
                                      },
                                      "searchTopCategory1Label": {
                                        "type": "string",
                                        "description": "Traffic top category 1 normalized label",
                                        "example": null
                                      },
                                      "reviewPositiveTop1Topic": {
                                        "type": "string",
                                        "description": "Positive review #1 topic",
                                        "example": null
                                      },
                                      "reviewPositiveTop1PctAtLeast": {
                                        "type": "number",
                                        "description": "Positive review #1 topic and its share among positive reviews",
                                        "example": 1
                                      },
                                      "reviewNegativeTop1Topic": {
                                        "type": "string",
                                        "description": "Negative review #1 topic",
                                        "example": null
                                      },
                                      "reviewNegativeTop1PctAtLeast": {
                                        "type": "number",
                                        "description": "Negative review #1 topic, share, and secondary cause",
                                        "example": 1
                                      },
                                      "reviewNegativeTop2Topic": {
                                        "type": "string",
                                        "description": "Negative review #2 topic",
                                        "example": null
                                      },
                                      "reviewStrategicInsightTags": {
                                        "type": "array",
                                        "description": "Review strategic insight tags",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": [
                      {
                        "keyword": "phone case",
                        "nicheRevenue360dMinUsdAtLeast": 1,
                        "nicheRevenue360dMaxUsdAtLeast": 1,
                        "nichePeakSearchVolumeAtLeast": 1,
                        "nichePeakMonth": 1,
                        "nicheSearchVolumeYoyChangePctAtLeast": 1,
                        "nicheBrandCount": 1,
                        "nicheBrandCountYoyChangePctAtLeast": 1,
                        "nicheTop5ProductClickSharePctAtLeast": 1,
                        "featureTop5BrandSharePctAtLeast": 1,
                        "featureTopBrands": [],
                        "priceMinUsd": 1,
                        "priceMaxUsd": 1,
                        "priceSweetSpotMinUsd": 1,
                        "priceSweetSpotMaxUsd": 1,
                        "priceEntryClickSharePctAtLeast": 1,
                        "priceMidClickSharePctAtLeast": 1,
                        "priceHighClickSharePctAtLeast": 1,
                        "demoPrimaryAgeMin": 1,
                        "demoPrimaryAgeMax": 1,
                        "demoLifeStageTags": [],
                        "featureNewAvgReviewCountAtLeast": 1,
                        "featureEstablishedAvgReviewCountAtLeast": 1,
                        "featureEmergingTrendTags": [],
                        "featureUncommonFeatureTags": [],
                        "reviewPositiveTop1PctAtLeast": 1,
                        "reviewNegativeTop1PctAtLeast": 1,
                        "reviewStrategicInsightTags": []
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-opportunity-search-by-metrics",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_opportunity_search_by_metrics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-policy-feed/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Policy Feed",
        "description": "Query Amazon is latest policy, regulation, and compliance feed. Supports paginated browsing by marketplace and time range (with AI-generated Chinese summaries), and fetching full article body by record ID. Trigger when users mention Amazon policies & regulations, seller compliance announcements, platform rule changes, policy alerts, FBA/fee policy updates, multi-marketplace policy tracking, policy original text, news details, or similar terms. Even if the user does not explicitly mention \"policy feed,\" trigger this skill whenever the request involves Amazon is officially published policies, regulations, and news for sellers, including their full text.",
        "operationId": "runAmazonPolicyFeed",
        "externalDocs": {
          "description": "Amazon Policy Feed documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-policy-feed"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-policy-feed.",
                "properties": {
                  "site": {
                    "type": "string",
                    "description": "Amazon site code, uppercase. Defaults to US.",
                    "example": "US"
                  },
                  "publishedAtGte": {
                    "type": "string",
                    "description": "Publication or change time lower bound, inclusive, format yyyy-MM-dd HH:mm:ss.",
                    "example": "2026-01-01 00:00:00"
                  },
                  "publishedAtLte": {
                    "type": "string",
                    "description": "Publication or change time upper bound, inclusive, format yyyy-MM-dd HH:mm:ss.",
                    "example": "2026-01-07 23:59:59"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting from 1.",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, range 1-100.",
                    "example": 20
                  },
                  "id": {
                    "type": "string",
                    "description": "News record ID from data[].id. Required when calling the policy detail endpoint.",
                    "example": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
                  }
                },
                "example": {
                  "site": "US",
                  "pageSize": 20,
                  "page": 1
                },
                "additionalProperties": true
              },
              "example": {
                "site": "US",
                "pageSize": 20,
                "page": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of news items returned by the list endpoint.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Upstream render style: tableListWorkbenches for the list or stdoutWorkbenches for detail.",
                                  "example": "tableListWorkbenches"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "News items in descending publication/change time from the list endpoint.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "description": "News record ID used to fetch the full body.",
                                        "example": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "News title in the list response.",
                                        "example": "Amazon policy update"
                                      },
                                      "summaryZh": {
                                        "type": "string",
                                        "description": "AI-generated Chinese summary for the news item.",
                                        "example": "Policy summary"
                                      },
                                      "originalUrl": {
                                        "type": "string",
                                        "description": "Original article URL.",
                                        "example": "https://example.com/news"
                                      },
                                      "publishedAt": {
                                        "type": "string",
                                        "description": "Publication or change time, format yyyy-MM-dd HH:mm:ss.",
                                        "example": "2026-01-01 00:00:00"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "stdout": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Full news body in Markdown format returned by the detail endpoint.",
                                  "example": "# Amazon policy update"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "News title returned by the detail endpoint.",
                                  "example": "Amazon policy update"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "summaryZh": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "AI-generated Chinese summary returned by the detail endpoint.",
                                  "example": "Policy summary"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total processing time in milliseconds.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Frontend column definitions returned by the list endpoint.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "type": "tableListWorkbenches",
                    "data": [
                      {
                        "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
                        "title": "Amazon policy update",
                        "summaryZh": "Policy summary",
                        "originalUrl": "https://example.com/news",
                        "publishedAt": "2026-01-01 00:00:00"
                      }
                    ],
                    "stdout": "# Amazon policy update",
                    "title": "Amazon policy update",
                    "summaryZh": "Policy summary",
                    "costTime": 1,
                    "costToken": 1,
                    "columns": []
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-policy-feed",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_policy_feed",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-product-database/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Product Database",
        "description": "Nexscope Product Database multi-condition filtering. Filter Amazon products by category, price, sales volume, revenue, reviews, rating, weight, BSR rank, LQS, seller type, and more across 10 marketplaces. Trigger when users mention Amazon product selection, product database filtering, BSR rank filtering, category-based product discovery, high-rating low-competition products, FBA product search, Amazon product discovery, or similar terms. Even if the user does not explicitly mention \"Nexscope\" or \"product database,\" trigger this skill whenever the request involves filtering Amazon products by multiple criteria or discovering potential products.",
        "operationId": "runAmazonProductDatabase",
        "externalDocs": {
          "description": "Amazon Product Database documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-product-database"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-product-database.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp",
                    "example": "us"
                  },
                  "includeKeywords": {
                    "type": "string",
                    "description": "Keywords to include in title/ASIN, comma-separated, up to 100 items, max 50 chars each",
                    "example": "phone case"
                  },
                  "excludeKeywords": {
                    "type": "string",
                    "description": "Keywords to exclude from title/ASIN, comma-separated, up to 100 items, max 50 chars each",
                    "example": "phone case"
                  },
                  "categories": {
                    "type": "string",
                    "description": "Primary category names, comma-separated, must match the standard category names for the corresponding site. US site examples: Appliances, Arts Crafts & Sewing, Automotive, Baby, Beauty & Personal Care, Books, CDs & Vinyl, Cell Phones & Accessories, Clothing Shoes & Jewelry, Collectibles & Fine Art, Computers, Digital Music, Electronics, Garden & Outdoor, Grocery & Gourmet Food, Handmade, Health Household & Baby Care, Home & Kitchen, Industrial & Scientific, Kindle Store, Kitchen & Dining, Movies & TV, Musical Instruments, Office Products, Pet Supplies, Sports & Outdoors, Tools & Home Improvement, Toys & Games, Video Games, etc. Other sites (uk, de, fr, it, es, mx, jp, ca, in) have their own localized category names"
                  },
                  "minPrice": {
                    "type": "number",
                    "description": "Minimum price",
                    "example": 1
                  },
                  "maxPrice": {
                    "type": "number",
                    "description": "Maximum price",
                    "example": 1
                  },
                  "minSales": {
                    "type": "integer",
                    "description": "Minimum monthly sales",
                    "example": 1
                  },
                  "maxSales": {
                    "type": "integer",
                    "description": "Maximum monthly sales",
                    "example": 1
                  },
                  "minRevenue": {
                    "type": "number",
                    "description": "Minimum monthly revenue",
                    "example": 1
                  },
                  "maxRevenue": {
                    "type": "number",
                    "description": "Maximum monthly revenue",
                    "example": 1
                  },
                  "minReviews": {
                    "type": "integer",
                    "description": "Minimum number of reviews",
                    "example": 1
                  },
                  "maxReviews": {
                    "type": "integer",
                    "description": "Maximum number of reviews",
                    "example": 1
                  },
                  "minRating": {
                    "type": "number",
                    "description": "Minimum rating (1.0-5.0)",
                    "example": 1
                  },
                  "maxRating": {
                    "type": "number",
                    "description": "Maximum rating (1.0-5.0)",
                    "example": 1
                  },
                  "minWeight": {
                    "type": "number",
                    "description": "Minimum weight (lbs)",
                    "example": 1
                  },
                  "maxWeight": {
                    "type": "number",
                    "description": "Maximum weight (lbs)",
                    "example": 1
                  },
                  "minRank": {
                    "type": "integer",
                    "description": "Minimum BSR ranking",
                    "example": 1
                  },
                  "maxRank": {
                    "type": "integer",
                    "description": "Maximum BSR ranking",
                    "example": 1
                  },
                  "minLqs": {
                    "type": "integer",
                    "description": "Minimum LQS score (1-10)",
                    "example": 1
                  },
                  "maxLqs": {
                    "type": "integer",
                    "description": "Maximum LQS score (1-10)",
                    "example": 1
                  },
                  "minSellers": {
                    "type": "integer",
                    "description": "Minimum number of sellers",
                    "example": 1
                  },
                  "maxSellers": {
                    "type": "integer",
                    "description": "Maximum number of sellers",
                    "example": 1
                  },
                  "minNet": {
                    "type": "number",
                    "description": "Minimum net profit",
                    "example": 1
                  },
                  "maxNet": {
                    "type": "number",
                    "description": "Maximum net profit",
                    "example": 1
                  },
                  "sellerTypes": {
                    "type": "string",
                    "description": "Seller types, comma-separated. Options: amz (Amazon self-operated), fba, fbm"
                  },
                  "productTiers": {
                    "type": "string",
                    "description": "Product size tiers, comma-separated. Options: oversize, standard"
                  },
                  "excludeTopBrands": {
                    "type": "boolean",
                    "description": "Whether to exclude top brands",
                    "example": false
                  },
                  "excludeUnavailableProducts": {
                    "type": "boolean",
                    "description": "Whether to exclude unavailable products",
                    "example": false
                  },
                  "minUpdatedAt": {
                    "type": "string",
                    "description": "Data update start date (YYYY-MM-DD)",
                    "example": "2026-01-01"
                  },
                  "maxUpdatedAt": {
                    "type": "string",
                    "description": "Data update end date (YYYY-MM-DD)",
                    "example": "2026-01-01"
                  },
                  "needCount": {
                    "type": "integer",
                    "description": "Total number of results to return, API auto-paginates internally",
                    "example": 1
                  },
                  "sort": {
                    "type": "string",
                    "description": "Sort field. Options: name, -name, category, -category, revenue, -revenue, sales, -sales, price, -price, rank, -rank, reviews, -reviews, lqs, -lqs, sellers, -sellers. Prefix - indicates descending. Default: name"
                  }
                },
                "required": [
                  "marketplace"
                ],
                "example": {
                  "sort": "-sales",
                  "marketplace": "us",
                  "includeKeywords": "phone case",
                  "needCount": 10
                },
                "additionalProperties": true
              },
              "example": {
                "sort": "-sales",
                "marketplace": "us",
                "includeKeywords": "phone case",
                "needCount": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "productDatabaseList": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product data list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "description": "Product unique identifier",
                                        "example": "example-id"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand name",
                                        "example": null
                                      },
                                      "category": {
                                        "type": "string",
                                        "description": "Primary category",
                                        "example": null
                                      },
                                      "breadcrumbPath": {
                                        "type": "string",
                                        "description": "Full category path",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current selling price (USD)",
                                        "example": 1
                                      },
                                      "approximate30DayUnitsSold": {
                                        "type": "integer",
                                        "description": "Estimated units sold in last 30 days",
                                        "example": 1
                                      },
                                      "approximate30DayRevenue": {
                                        "type": "number",
                                        "description": "Estimated revenue in last 30 days (USD)",
                                        "example": 1
                                      },
                                      "productRank": {
                                        "type": "integer",
                                        "description": "BSR ranking",
                                        "example": 1
                                      },
                                      "reviews": {
                                        "type": "integer",
                                        "description": "Total number of reviews",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Average rating (1.0-5.0)",
                                        "example": 1
                                      },
                                      "listingQualityScore": {
                                        "type": "integer",
                                        "description": "Listing quality score (LQS, 1-10)",
                                        "example": 1
                                      },
                                      "numberOfSellers": {
                                        "type": "integer",
                                        "description": "Number of active sellers",
                                        "example": 1
                                      },
                                      "sellerType": {
                                        "type": "string",
                                        "description": "Seller type (amz/fba/fbm)",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "dateFirstAvailable": {
                                        "type": "string",
                                        "description": "Date first listed",
                                        "example": "2026-01-01"
                                      },
                                      "weightValue": {
                                        "type": "number",
                                        "description": "Product weight",
                                        "example": 1
                                      },
                                      "weightUnit": {
                                        "type": "string",
                                        "description": "Weight unit",
                                        "example": null
                                      },
                                      "lengthValue": {
                                        "type": "number",
                                        "description": "Length",
                                        "example": 1
                                      },
                                      "widthValue": {
                                        "type": "number",
                                        "description": "Width",
                                        "example": 1
                                      },
                                      "heightValue": {
                                        "type": "number",
                                        "description": "Height",
                                        "example": 1
                                      },
                                      "dimensionsUnit": {
                                        "type": "string",
                                        "description": "Dimensions unit",
                                        "example": null
                                      },
                                      "parentAsin": {
                                        "type": "string",
                                        "description": "Parent ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "isParent": {
                                        "type": "boolean",
                                        "description": "Whether it is a parent listing",
                                        "example": false
                                      },
                                      "isVariant": {
                                        "type": "boolean",
                                        "description": "Whether it is a variant",
                                        "example": false
                                      },
                                      "isStandalone": {
                                        "type": "boolean",
                                        "description": "Whether it is a standalone product",
                                        "example": false
                                      },
                                      "isAvailable": {
                                        "type": "boolean",
                                        "description": "Whether it is available for purchase",
                                        "example": false
                                      },
                                      "buyBoxOwner": {
                                        "type": "string",
                                        "description": "Buy Box owner seller name",
                                        "example": null
                                      },
                                      "buyBoxOwnerSellerId": {
                                        "type": "string",
                                        "description": "Buy Box owner seller ID",
                                        "example": "example-id"
                                      },
                                      "updatedAt": {
                                        "type": "string",
                                        "description": "Data update time",
                                        "example": "2026-01-01"
                                      },
                                      "feeBreakdown": {
                                        "type": "object",
                                        "description": "Fee details: fbaFee (FBA fee), referralFee (referral fee), variableClosingFee (variable closing fee), totalFees (total fees)",
                                        "example": {}
                                      },
                                      "subcategoryRanks": {
                                        "type": "array",
                                        "description": "Subcategory BSR ranking list, each item contains subcategory, rank, id",
                                        "example": []
                                      },
                                      "type": {
                                        "type": "string",
                                        "description": "Resource type",
                                        "example": null
                                      },
                                      "variants": {
                                        "type": "array",
                                        "description": "Variant list",
                                        "example": []
                                      },
                                      "upcList": {
                                        "type": "array",
                                        "description": "UPC code list",
                                        "example": []
                                      },
                                      "eanList": {
                                        "type": "array",
                                        "description": "EAN code list",
                                        "example": []
                                      },
                                      "isbnList": {
                                        "type": "array",
                                        "description": "ISBN code list",
                                        "example": []
                                      },
                                      "gtinList": {
                                        "type": "array",
                                        "description": "GTIN code list",
                                        "example": []
                                      },
                                      "dateFirstAvailableIsEstimated": {
                                        "type": "boolean",
                                        "description": "Whether the listing date is estimated",
                                        "example": false
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "costToken": 1,
                    "productDatabaseList": [
                      {
                        "id": "example-id",
                        "price": 1,
                        "approximate30DayUnitsSold": 1,
                        "approximate30DayRevenue": 1,
                        "productRank": 1,
                        "reviews": 1,
                        "rating": 1,
                        "listingQualityScore": 1,
                        "numberOfSellers": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "dateFirstAvailable": "2026-01-01",
                        "weightValue": 1,
                        "lengthValue": 1,
                        "widthValue": 1,
                        "heightValue": 1,
                        "parentAsin": "B072MQ5BRX",
                        "isParent": false,
                        "isVariant": false,
                        "isStandalone": false,
                        "isAvailable": false,
                        "buyBoxOwnerSellerId": "example-id",
                        "updatedAt": "2026-01-01",
                        "feeBreakdown": {},
                        "subcategoryRanks": [],
                        "variants": [],
                        "upcList": [],
                        "eanList": [],
                        "isbnList": [],
                        "gtinList": [],
                        "dateFirstAvailableIsEstimated": false
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-product-database",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_product_database",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-product-database-search/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Product Database Search",
        "description": "Advanced Amazon product search and filtering powered by Nexscope data, supporting multi-dimensional criteria including category, price, monthly sales, keywords, BSR rank, review count, rating, package dimensions, weight, fulfillment type, and more. Trigger when users mention Nexscope product selection, Amazon product search, advanced product selection, BSR filtering, sales rank filtering, keyword-based product discovery, category search, competitor screening, niche product discovery, historical rank filtering, or similar terms. Even if the user does not explicitly mention \"Nexscope,\" trigger this skill whenever the request involves multi-criteria Amazon product search, sales-metric-based filtering, or advanced product selection beyond simple keyword search.",
        "operationId": "runAmazonProductDatabaseSearch",
        "externalDocs": {
          "description": "Amazon Product Database Search documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-product-database-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-product-database-search.",
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "Amazon domain ID: 1=United States, 2=United Kingdom, 3=Germany, 4=France, 5=Japan, 6=Canada, 8=Italy, 9=Spain, 10=India, 11=Mexico",
                    "example": "1"
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Title keyword (case-insensitive; spaces mean AND tokenization; wrap keywords containing spaces in double quotes; prefix - for exclusion; & symbol is replaced with space; up to 50 keywords, max 1000 characters)",
                    "example": "phone case"
                  },
                  "rootCategory": {
                    "type": "array",
                    "items": {},
                    "description": "Root category IDs (up to 50), only include products in these root categories",
                    "example": []
                  },
                  "rootCategoryNames": {
                    "type": "array",
                    "items": {},
                    "description": "Root category names (up to 50), used when rootCategory is empty; the system automatically looks up corresponding category IDs",
                    "example": []
                  },
                  "categoriesInclude": {
                    "type": "array",
                    "items": {},
                    "description": "Subcategory IDs to include only (up to 50), only include products directly listed in these subcategories",
                    "example": []
                  },
                  "categoriesIncludeNames": {
                    "type": "array",
                    "items": {},
                    "description": "Subcategory names to include (up to 50), used when categoriesInclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths (separated by : or >) for more accurate results",
                    "example": []
                  },
                  "categoriesExclude": {
                    "type": "array",
                    "items": {},
                    "description": "Subcategory IDs to exclude (up to 50)",
                    "example": []
                  },
                  "categoriesExcludeNames": {
                    "type": "array",
                    "items": {},
                    "description": "Subcategory names to exclude (up to 50), used when categoriesExclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths for more accurate results",
                    "example": []
                  },
                  "currentSalesGte/currentSalesLte": {
                    "type": "integer",
                    "description": "Current sales rank range (lower value = better ranking)",
                    "example": 1
                  },
                  "avg90SalesGte/avg90SalesLte": {
                    "type": "integer",
                    "description": "90-day average sales rank range",
                    "example": 1
                  },
                  "deltaPercent90SalesGte/deltaPercent90SalesLte": {
                    "type": "integer",
                    "description": "90-day sales rank change percentage range",
                    "example": 1
                  },
                  "monthlySoldGte/monthlySoldLte": {
                    "type": "integer",
                    "description": "Units sold / monthly sales range",
                    "example": 1
                  },
                  "srAvgGte/srAvgLte": {
                    "type": "integer",
                    "description": "Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth)",
                    "example": 1
                  },
                  "srAvgMonth": {
                    "type": "string",
                    "description": "Historical sales rank - selected month (format: YYYYMM, e.g., 202511 for November 2025, within the last 36 months)"
                  },
                  "currentNewGte/currentNewLte": {
                    "type": "integer",
                    "description": "Current new price range (in minor currency unit)",
                    "example": 1
                  },
                  "currentBuyBoxShippingGte/currentBuyBoxShippingLte": {
                    "type": "integer",
                    "description": "Current Buy Box price with shipping range (in minor currency unit)",
                    "example": 1
                  },
                  "currentCountReviewsGte/currentCountReviewsLte": {
                    "type": "integer",
                    "description": "Current review count range",
                    "example": 1
                  },
                  "currentRatingGte/currentRatingLte": {
                    "type": "number",
                    "description": "Current rating range (0.0-5.0)",
                    "example": 1
                  },
                  "packageLengthGte/packageLengthLte": {
                    "type": "integer",
                    "description": "Package length range (mm)",
                    "example": 1
                  },
                  "packageWidthGte/packageWidthLte": {
                    "type": "integer",
                    "description": "Package width range (mm)",
                    "example": 1
                  },
                  "packageHeightGte/packageHeightLte": {
                    "type": "integer",
                    "description": "Package height range (mm)",
                    "example": 1
                  },
                  "packageWeightGte/packageWeightLte": {
                    "type": "integer",
                    "description": "Package weight range (grams)",
                    "example": 1
                  },
                  "brand": {
                    "type": "array",
                    "items": {},
                    "description": "Brand (OR match)",
                    "example": []
                  },
                  "color": {
                    "type": "array",
                    "items": {},
                    "description": "Color (OR match), filter products with specified colors",
                    "example": []
                  },
                  "size": {
                    "type": "array",
                    "items": {},
                    "description": "Size (OR match), filter products with specified sizes",
                    "example": []
                  },
                  "availableDateGte/availableDateLte": {
                    "type": "string",
                    "description": "Product listing time range (date format: yyyy-MM-dd)",
                    "example": "2026-01-01"
                  },
                  "buyBoxIsAmazon": {
                    "type": "boolean",
                    "description": "Whether the Buy Box seller is Amazon",
                    "example": false
                  },
                  "buyBoxIsFBA": {
                    "type": "boolean",
                    "description": "Whether the Buy Box is FBA",
                    "example": false
                  },
                  "isHazMat": {
                    "type": "boolean",
                    "description": "Whether it is hazardous material",
                    "example": false
                  },
                  "variationCountGte/variationCountLte": {
                    "type": "integer",
                    "description": "Variation count range",
                    "example": 1
                  },
                  "currentCountNewGte/currentCountNewLte": {
                    "type": "integer",
                    "description": "Current new offer count range",
                    "example": 1
                  },
                  "outOfStockPercentage90Gte/outOfStockPercentage90Lte": {
                    "type": "integer",
                    "description": "90-day out-of-stock percentage range",
                    "example": 1
                  },
                  "singleVariation": {
                    "type": "boolean",
                    "description": "Return only one variation; when set to true, multi-variation products will only return one variation",
                    "example": false
                  },
                  "productType": {
                    "type": "array",
                    "items": {},
                    "description": "Product type filter (default [0,1,2]): 0=standard product, 1=downloadable product, 2=eBook, 5=variant parent ASIN",
                    "example": []
                  },
                  "history": {
                    "type": "integer",
                    "description": "Whether to include historical data / historical sales in the response (1=include, 0=exclude, default 0)",
                    "example": 1
                  },
                  "rating": {
                    "type": "integer",
                    "description": "Whether to fetch rating info (1=fetch, 0=do not fetch, default 1)",
                    "example": 1
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1, default 1)",
                    "example": 1
                  },
                  "perPage": {
                    "type": "integer",
                    "description": "Maximum results per page (min 50, max 100, default 50)",
                    "example": 50
                  },
                  "sort": {
                    "type": "array",
                    "items": {},
                    "description": "Sort (up to 3): array of objects, each containing {\"fieldName\": \"...\", \"sortDirection\": \"asc\\",
                    "example": []
                  }
                },
                "required": [
                  "domain"
                ],
                "example": {
                  "page": 1,
                  "perPage": 50,
                  "domain": "1",
                  "keyword": "phone case"
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "perPage": 50,
                "domain": "1",
                "keyword": "phone case"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total rows",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "perPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Items per page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "currentPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page number",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: Nexscope",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "manufacturer": {
                                        "type": "string",
                                        "description": "Manufacturer",
                                        "example": null
                                      },
                                      "model": {
                                        "type": "string",
                                        "description": "Model",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current price (in local currency, e.g., USD/EUR)",
                                        "example": 1
                                      },
                                      "primePrice": {
                                        "type": "number",
                                        "description": "Prime price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "salesRank": {
                                        "type": "integer",
                                        "description": "Sales rank",
                                        "example": 1
                                      },
                                      "salesRank30": {
                                        "type": "integer",
                                        "description": "Average sales rank in last 30 days",
                                        "example": 1
                                      },
                                      "salesRank90": {
                                        "type": "integer",
                                        "description": "Average sales rank in last 90 days",
                                        "example": 1
                                      },
                                      "salesRank180": {
                                        "type": "integer",
                                        "description": "Average sales rank in last 180 days",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Monthly sales units",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Monthly sales revenue",
                                        "example": 1
                                      },
                                      "monthlySalesUnits1MonthAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 1 month ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits2MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 2 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits3MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 3 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits4MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 4 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits5MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 5 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits6MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 6 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits7MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 7 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits8MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 8 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits9MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 9 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits10MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 10 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits11MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 11 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits12MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales units 12 months ago",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Current rating (0.0-5.0)",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Number of ratings",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time (yyyy-MM-dd HH:mm:ss)",
                                        "example": "2026-01-01 00:00:00"
                                      },
                                      "lastUpdate": {
                                        "type": "string",
                                        "description": "Last update time (yyyy-MM-dd HH:mm:ss)",
                                        "example": "2026-01-01 00:00:00"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Image URL (request address)",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Product image list",
                                        "example": []
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Amazon ASIN detail page URL",
                                        "example": "https://www.amazon.com/dp/B072MQ5BRX"
                                      },
                                      "categoryTree": {
                                        "type": "string",
                                        "description": "Category tree",
                                        "example": null
                                      },
                                      "categoryTreeId": {
                                        "type": "string",
                                        "description": "Category tree ID",
                                        "example": "example-id"
                                      },
                                      "rootCategory": {
                                        "type": "integer",
                                        "description": "Root category ID",
                                        "example": 1
                                      },
                                      "subcategories": {
                                        "type": "array",
                                        "description": "Subcategory list, containing code (category ID), rank (ranking), label (category name)",
                                        "example": []
                                      },
                                      "fulfillment": {
                                        "type": "string",
                                        "description": "Fulfillment method (AMZ, FBA, FBM)",
                                        "example": null
                                      },
                                      "buyBoxSellerId": {
                                        "type": "string",
                                        "description": "Buy Box seller ID",
                                        "example": "example-id"
                                      },
                                      "sellerNum": {
                                        "type": "integer",
                                        "description": "Number of sellers",
                                        "example": 1
                                      },
                                      "parentAsin": {
                                        "type": "string",
                                        "description": "Parent ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "variationNum": {
                                        "type": "integer",
                                        "description": "Number of variations",
                                        "example": 1
                                      },
                                      "color": {
                                        "type": "string",
                                        "description": "Color",
                                        "example": null
                                      },
                                      "dimension": {
                                        "type": "string",
                                        "description": "Dimensions",
                                        "example": null
                                      },
                                      "dimensionsType": {
                                        "type": "string",
                                        "description": "Dimensions type",
                                        "example": null
                                      },
                                      "material": {
                                        "type": "string",
                                        "description": "Product material, the primary material used in its construction",
                                        "example": null
                                      },
                                      "weight": {
                                        "type": "string",
                                        "description": "Weight (grams)",
                                        "example": null
                                      },
                                      "packageWeight": {
                                        "type": "string",
                                        "description": "Package weight (grams)",
                                        "example": null
                                      },
                                      "packageLength": {
                                        "type": "integer",
                                        "description": "Package length (mm)",
                                        "example": 1
                                      },
                                      "packageWidth": {
                                        "type": "integer",
                                        "description": "Package width (mm)",
                                        "example": 1
                                      },
                                      "packageHeight": {
                                        "type": "integer",
                                        "description": "Package height (mm)",
                                        "example": 1
                                      },
                                      "packageDimensions": {
                                        "type": "string",
                                        "description": "Package dimensions",
                                        "example": null
                                      },
                                      "packageQuantity": {
                                        "type": "integer",
                                        "description": "Quantity of items in the package, 0 or -1 if unavailable",
                                        "example": 1
                                      },
                                      "itemLength": {
                                        "type": "integer",
                                        "description": "Item length (mm), 0 or -1 if unavailable",
                                        "example": 1
                                      },
                                      "itemWidth": {
                                        "type": "integer",
                                        "description": "Item width (mm), 0 or -1 if unavailable",
                                        "example": 1
                                      },
                                      "itemHeight": {
                                        "type": "integer",
                                        "description": "Item height (mm), 0 or -1 if unavailable",
                                        "example": 1
                                      },
                                      "isAdultProduct": {
                                        "type": "boolean",
                                        "description": "Whether it is an adult product",
                                        "example": false
                                      },
                                      "isHazmat": {
                                        "type": "boolean",
                                        "description": "Whether it is hazardous material",
                                        "example": false
                                      },
                                      "referralFeePercentage": {
                                        "type": "number",
                                        "description": "Referral fee percentage",
                                        "example": 1
                                      },
                                      "fbaFees": {
                                        "type": "number",
                                        "description": "FBA fulfillment fee (in local currency)",
                                        "example": 1
                                      },
                                      "profit": {
                                        "type": "number",
                                        "description": "Profit margin (percentage, e.g., 25.5 means 25.5%)",
                                        "example": 1
                                      },
                                      "urlSlug": {
                                        "type": "string",
                                        "description": "URL slug",
                                        "example": "example-product"
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source type: Nexscope",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "perPage": 1,
                    "currentPage": 1,
                    "totalCount": 1,
                    "columns": [],
                    "costToken": 1,
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "price": 1,
                        "primePrice": 1,
                        "salesRank": 1,
                        "salesRank30": 1,
                        "salesRank90": 1,
                        "salesRank180": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "monthlySalesUnits1MonthAgo": 1,
                        "monthlySalesUnits2MonthsAgo": 1,
                        "monthlySalesUnits3MonthsAgo": 1,
                        "monthlySalesUnits4MonthsAgo": 1,
                        "monthlySalesUnits5MonthsAgo": 1,
                        "monthlySalesUnits6MonthsAgo": 1,
                        "monthlySalesUnits7MonthsAgo": 1,
                        "monthlySalesUnits8MonthsAgo": 1,
                        "monthlySalesUnits9MonthsAgo": 1,
                        "monthlySalesUnits10MonthsAgo": 1,
                        "monthlySalesUnits11MonthsAgo": 1,
                        "monthlySalesUnits12MonthsAgo": 1,
                        "rating": 1,
                        "ratings": 1,
                        "reviewCount": 1,
                        "availableDate": "2026-01-01 00:00:00",
                        "lastUpdate": "2026-01-01 00:00:00",
                        "imageUrl": "https://example.com/image.jpg",
                        "productImageUrls": [],
                        "asinUrl": "https://www.amazon.com/dp/B072MQ5BRX",
                        "categoryTreeId": "example-id",
                        "rootCategory": 1,
                        "subcategories": [],
                        "buyBoxSellerId": "example-id",
                        "sellerNum": 1,
                        "parentAsin": "B072MQ5BRX",
                        "variationNum": 1,
                        "packageLength": 1,
                        "packageWidth": 1,
                        "packageHeight": 1,
                        "packageQuantity": 1,
                        "itemLength": 1,
                        "itemWidth": 1,
                        "itemHeight": 1,
                        "isAdultProduct": false,
                        "isHazmat": false,
                        "referralFeePercentage": 1,
                        "fbaFees": 1,
                        "profit": 1,
                        "urlSlug": "example-product"
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-product-database-search",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_product_database_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-product-detail/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Product Detail",
        "description": "Retrieve detailed Amazon product information by ASIN, including title, Item Highlights when extractable from raw HTML, images, bullet points, specifications, A+ content, pricing, ratings & reviews, variants, and more. Trigger when users mention Amazon product details, ASIN lookup, Item Highlights, product page data, listing analysis, bullet point extraction, product image retrieval, variant inspection, competitor listing research, price lookup, review breakdown, product specification query, or similar terms. Even if the user does not explicitly say \"product details,\" trigger this skill whenever the request involves retrieving structured data from Amazon product pages via ASIN.",
        "operationId": "runAmazonProductDetail",
        "externalDocs": {
          "description": "Amazon Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-product-detail.",
                "properties": {
                  "asins": {
                    "type": "string",
                    "description": "ASIN list, supports batch query, up to 40 ASINs. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$. Example: B072MQ5BRX,B08N5WRWNW",
                    "example": "B072MQ5BRX"
                  },
                  "amazonDomain": {
                    "type": "string",
                    "description": "Amazon country site, default amazon.com. Options: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.co.jp, amazon.ca, amazon.com.au, amazon.com.br, amazon.in, amazon.nl, amazon.se, amazon.pl, amazon.sg, amazon.sa, amazon.ae, amazon.com.tr, amazon.com.mx, amazon.eg, amazon.cn, amazon.com.be"
                  },
                  "language": {
                    "type": "string",
                    "description": "Language. Examples: en_US, de_DE, fr_FR, ja_JP, it_IT, es_ES, pt_BR, en_GB, zh_CN"
                  },
                  "deliveryZip": {
                    "type": "string",
                    "description": "Delivery zip code, used to get delivery-related pricing. Examples: 10001 (New York, US), 10115 (Berlin, Germany), EC1A 1BB (London, UK)"
                  },
                  "device": {
                    "type": "string",
                    "description": "Device type: desktop (default), mobile, tablet"
                  },
                  "returnBoughtTogether": {
                    "type": "boolean",
                    "description": "Whether to return frequently bought together items (boughtTogether), default false",
                    "example": false
                  },
                  "returnRelatedProducts": {
                    "type": "boolean",
                    "description": "Whether to return related product list (relatedProducts), default false",
                    "example": false
                  },
                  "returnAuthorsReviews": {
                    "type": "boolean",
                    "description": "Whether to return author review list (authorsReviews), default false",
                    "example": false
                  }
                },
                "required": [
                  "asins"
                ],
                "example": {
                  "returnRelatedProducts": false,
                  "returnBoughtTogether": false,
                  "asins": "B072MQ5BRX",
                  "returnAuthorsReviews": false
                },
                "additionalProperties": true
              },
              "example": {
                "returnRelatedProducts": false,
                "returnBoughtTogether": false,
                "asins": "B072MQ5BRX",
                "returnAuthorsReviews": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total rows",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "ASIN code",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Price",
                                        "example": 1
                                      },
                                      "extractedPrice": {
                                        "type": "number",
                                        "description": "Extracted price",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "Original price",
                                        "example": 1
                                      },
                                      "extractedOldPrice": {
                                        "type": "number",
                                        "description": "Extracted original price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "discount": {
                                        "type": "string",
                                        "description": "Discount",
                                        "example": null
                                      },
                                      "saveWithCoupon": {
                                        "type": "string",
                                        "description": "Amount saved with coupon",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "prime": {
                                        "type": "boolean",
                                        "description": "Whether it is a Prime item",
                                        "example": false
                                      },
                                      "stock": {
                                        "type": "string",
                                        "description": "Stock status",
                                        "example": null
                                      },
                                      "delivery": {
                                        "type": "string",
                                        "description": "Delivery information",
                                        "example": null
                                      },
                                      "link": {
                                        "type": "string",
                                        "description": "Product link",
                                        "example": null
                                      },
                                      "linkClean": {
                                        "type": "string",
                                        "description": "Clean link",
                                        "example": null
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Amazon ASIN link",
                                        "example": "https://www.amazon.com/dp/B072MQ5BRX"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Thumbnail",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "thumbnail": {
                                        "type": "string",
                                        "description": "Thumbnail",
                                        "example": null
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Product image URL list",
                                        "example": []
                                      },
                                      "aboutItem": {
                                        "type": "array",
                                        "description": "Bullet points",
                                        "example": []
                                      },
                                      "productDescription": {
                                        "type": "string",
                                        "description": "Product description; when A+ content exists, this is a JSON string (see A+ structure below)",
                                        "example": null
                                      },
                                      "description": {
                                        "type": "string",
                                        "description": "Product description",
                                        "example": null
                                      },
                                      "dimension": {
                                        "type": "string",
                                        "description": "Product dimensions",
                                        "example": null
                                      },
                                      "weight": {
                                        "type": "string",
                                        "description": "Weight",
                                        "example": null
                                      },
                                      "tags": {
                                        "type": "string",
                                        "description": "Tag list",
                                        "example": null
                                      },
                                      "badges": {
                                        "type": "string",
                                        "description": "Badge list",
                                        "example": null
                                      },
                                      "climatePledgeFriendly": {
                                        "type": "boolean",
                                        "description": "Whether it is Climate Pledge Friendly",
                                        "example": false
                                      },
                                      "snapEbtEligible": {
                                        "type": "boolean",
                                        "description": "Whether SNAP EBT eligible",
                                        "example": false
                                      },
                                      "boughtLastMonth": {
                                        "type": "string",
                                        "description": "Units bought last month (string)",
                                        "example": null
                                      },
                                      "boughtLastMonthCount": {
                                        "type": "integer",
                                        "description": "Units bought last month (number)",
                                        "example": 1
                                      },
                                      "reviewsSummary": {
                                        "type": "string",
                                        "description": "Review summary",
                                        "example": null
                                      },
                                      "reviewsImages": {
                                        "type": "array",
                                        "description": "Review image list",
                                        "example": []
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source type: amazon",
                                        "example": null
                                      },
                                      "pageFileUrl": {
                                        "type": "string",
                                        "description": "Processed product JSON file URL; not raw HTML",
                                        "example": "https://example.com/product.json"
                                      },
                                      "rawHtmlFile": {
                                        "type": "string",
                                        "description": "Raw Amazon product-page HTML URL from the upstream provider; optional and matched to the containing product ASIN",
                                        "example": "https://example.com/product.html"
                                      },
                                      "productDetails": {
                                        "type": "object",
                                        "description": "Detailed product specifications.",
                                        "example": null,
                                        "properties": {
                                          "asin": {
                                            "type": "string",
                                            "description": "ASIN code.",
                                            "example": null
                                          },
                                          "manufacturer": {
                                            "type": "string",
                                            "description": "Manufacturer.",
                                            "example": null
                                          },
                                          "productDimensions": {
                                            "type": "string",
                                            "description": "Product dimensions.",
                                            "example": null
                                          },
                                          "upc": {
                                            "type": "string",
                                            "description": "UPC code.",
                                            "example": null
                                          },
                                          "units": {
                                            "type": "string",
                                            "description": "Units.",
                                            "example": null
                                          },
                                          "rating": {
                                            "type": "number",
                                            "description": "Rating.",
                                            "example": null
                                          },
                                          "review": {
                                            "type": "integer",
                                            "description": "Number of reviews.",
                                            "example": null
                                          }
                                        }
                                      },
                                      "customerReviews": {
                                        "type": "object",
                                        "description": "Star rating distribution.",
                                        "example": null,
                                        "properties": {
                                          "fiveStar": {
                                            "type": "integer",
                                            "description": "Five-star review count.",
                                            "example": null
                                          },
                                          "fourStar": {
                                            "type": "integer",
                                            "description": "Four-star review count.",
                                            "example": null
                                          },
                                          "threeStar": {
                                            "type": "integer",
                                            "description": "Three-star review count.",
                                            "example": null
                                          },
                                          "twoStar": {
                                            "type": "integer",
                                            "description": "Two-star review count.",
                                            "example": null
                                          },
                                          "oneStar": {
                                            "type": "integer",
                                            "description": "One-star review count.",
                                            "example": null
                                          }
                                        }
                                      },
                                      "variants": {
                                        "type": "array",
                                        "description": "Product variant groups.",
                                        "example": null,
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "title": {
                                              "type": "string",
                                              "description": "Variant group title, such as color or size.",
                                              "example": null
                                            },
                                            "items": {
                                              "type": "array",
                                              "description": "Variant items.",
                                              "example": null,
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "name": {
                                                    "type": "string",
                                                    "description": "Variant name.",
                                                    "example": null
                                                  },
                                                  "asin": {
                                                    "type": "string",
                                                    "description": "Variant ASIN.",
                                                    "example": null
                                                  },
                                                  "position": {
                                                    "type": "integer",
                                                    "description": "Variant position.",
                                                    "example": null
                                                  },
                                                  "selected": {
                                                    "type": "boolean",
                                                    "description": "Whether this variant is selected.",
                                                    "example": null
                                                  }
                                                }
                                              }
                                            }
                                          }
                                        }
                                      },
                                      "itemSpecifications": {
                                        "type": "object",
                                        "description": "Dynamic product specification keys and values.",
                                        "example": null
                                      },
                                      "itemIngredients": {
                                        "type": "array",
                                        "description": "Product ingredients.",
                                        "example": null
                                      },
                                      "boughtTogether": {
                                        "type": "array",
                                        "description": "Frequently bought together items when requested.",
                                        "example": null,
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "asin": {
                                              "type": "string",
                                              "description": "Related ASIN.",
                                              "example": null
                                            },
                                            "title": {
                                              "type": "string",
                                              "description": "Related product title.",
                                              "example": null
                                            },
                                            "price": {
                                              "type": "string",
                                              "description": "Related product price.",
                                              "example": null
                                            },
                                            "extractedPrice": {
                                              "type": "number",
                                              "description": "Parsed related product price.",
                                              "example": null
                                            },
                                            "priceUnit": {
                                              "type": "string",
                                              "description": "Related product unit price.",
                                              "example": null
                                            },
                                            "extractedPriceUnit": {
                                              "type": "number",
                                              "description": "Parsed related product unit price.",
                                              "example": null
                                            },
                                            "thumbnail": {
                                              "type": "string",
                                              "description": "Related product thumbnail.",
                                              "example": null
                                            },
                                            "link": {
                                              "type": "string",
                                              "description": "Related product link.",
                                              "example": null
                                            },
                                            "linkClean": {
                                              "type": "string",
                                              "description": "Clean related product link.",
                                              "example": null
                                            },
                                            "stock": {
                                              "type": "string",
                                              "description": "Related product stock status.",
                                              "example": null
                                            },
                                            "delivery": {
                                              "type": "array",
                                              "description": "Related product delivery information.",
                                              "example": null
                                            },
                                            "position": {
                                              "type": "integer",
                                              "description": "Related product position.",
                                              "example": null
                                            }
                                          }
                                        }
                                      },
                                      "relatedProducts": {
                                        "type": "array",
                                        "description": "Related products when requested.",
                                        "example": null,
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "asin": {
                                              "type": "string",
                                              "description": "Related ASIN.",
                                              "example": null
                                            },
                                            "title": {
                                              "type": "string",
                                              "description": "Related product title.",
                                              "example": null
                                            },
                                            "price": {
                                              "type": "string",
                                              "description": "Related product price.",
                                              "example": null
                                            },
                                            "extractedPrice": {
                                              "type": "number",
                                              "description": "Parsed related product price.",
                                              "example": null
                                            },
                                            "oldPrice": {
                                              "type": "string",
                                              "description": "Related product original price.",
                                              "example": null
                                            },
                                            "extractedOldPrice": {
                                              "type": "number",
                                              "description": "Parsed original price.",
                                              "example": null
                                            },
                                            "priceUnit": {
                                              "type": "string",
                                              "description": "Related product unit price.",
                                              "example": null
                                            },
                                            "extractedPriceUnit": {
                                              "type": "number",
                                              "description": "Parsed related product unit price.",
                                              "example": null
                                            },
                                            "rating": {
                                              "type": "number",
                                              "description": "Related product rating.",
                                              "example": null
                                            },
                                            "reviews": {
                                              "type": "integer",
                                              "description": "Related product review count.",
                                              "example": null
                                            },
                                            "thumbnail": {
                                              "type": "string",
                                              "description": "Related product thumbnail.",
                                              "example": null
                                            },
                                            "link": {
                                              "type": "string",
                                              "description": "Related product link.",
                                              "example": null
                                            },
                                            "linkClean": {
                                              "type": "string",
                                              "description": "Clean related product link.",
                                              "example": null
                                            },
                                            "prime": {
                                              "type": "boolean",
                                              "description": "Whether related product is Prime.",
                                              "example": null
                                            },
                                            "sponsored": {
                                              "type": "boolean",
                                              "description": "Whether related product is sponsored.",
                                              "example": null
                                            },
                                            "climatePledgeFriendly": {
                                              "type": "boolean",
                                              "description": "Whether related product is Climate Pledge Friendly.",
                                              "example": null
                                            },
                                            "discount": {
                                              "type": "string",
                                              "description": "Related product discount.",
                                              "example": null
                                            },
                                            "badges": {
                                              "type": "array",
                                              "description": "Related product badges.",
                                              "example": null
                                            },
                                            "position": {
                                              "type": "integer",
                                              "description": "Related product position.",
                                              "example": null
                                            }
                                          }
                                        }
                                      },
                                      "authorsReviews": {
                                        "type": "array",
                                        "description": "Author reviews when requested.",
                                        "example": null,
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "title": {
                                              "type": "string",
                                              "description": "Review title.",
                                              "example": null
                                            },
                                            "text": {
                                              "type": "string",
                                              "description": "Review content.",
                                              "example": null
                                            },
                                            "author": {
                                              "type": "string",
                                              "description": "Review author.",
                                              "example": null
                                            },
                                            "authorImage": {
                                              "type": "string",
                                              "description": "Author avatar.",
                                              "example": null
                                            },
                                            "authorLink": {
                                              "type": "string",
                                              "description": "Author link.",
                                              "example": null
                                            },
                                            "rating": {
                                              "type": "integer",
                                              "description": "Review rating.",
                                              "example": null
                                            },
                                            "date": {
                                              "type": "string",
                                              "description": "Review date.",
                                              "example": null
                                            },
                                            "verifiedPurchase": {
                                              "type": "boolean",
                                              "description": "Whether purchase is verified.",
                                              "example": null
                                            },
                                            "helpfulVotes": {
                                              "type": "string",
                                              "description": "Helpful vote count.",
                                              "example": null
                                            },
                                            "productSize": {
                                              "type": "string",
                                              "description": "Reviewed product size.",
                                              "example": null
                                            },
                                            "productFlavorName": {
                                              "type": "string",
                                              "description": "Reviewed product flavor.",
                                              "example": null
                                            },
                                            "position": {
                                              "type": "integer",
                                              "description": "Review position.",
                                              "example": null
                                            }
                                          }
                                        }
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "columns": [],
                    "costToken": 1,
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "price": 1,
                        "extractedPrice": 1,
                        "oldPrice": 1,
                        "extractedOldPrice": 1,
                        "rating": 1,
                        "ratings": 1,
                        "prime": false,
                        "asinUrl": "https://www.amazon.com/dp/B072MQ5BRX",
                        "imageUrl": "https://example.com/image.jpg",
                        "productImageUrls": [],
                        "aboutItem": [],
                        "climatePledgeFriendly": false,
                        "snapEbtEligible": false,
                        "boughtLastMonthCount": 1,
                        "reviewsImages": [],
                        "pageFileUrl": "https://example.com/product.json",
                        "rawHtmlFile": "https://example.com/product.html"
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-product-discovery/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Product Discovery",
        "description": "Amazon product discovery and potential bestseller mining via Nexscope data. Triggered when users mention product mining, potential bestsellers, high-conversion product selection, click growth analysis, market growth opportunities, keyword-based product selection, FBA profit screening, niche market product discovery, seller origin filtering, Nexscope data, FBA profitability screening, keyword-based product selection. Even if users do not explicitly mention \"Nexscope\", this skill should be triggered whenever the task involves keyword-driven Amazon product selection based on conversion rates, click volume, and profitability metrics.",
        "operationId": "runAmazonProductDiscovery",
        "externalDocs": {
          "description": "Amazon Product Discovery documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-product-discovery"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-product-discovery.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Keyword (required; translate the keyword to the language of the selected country)",
                    "example": "phone case"
                  },
                  "countryCode": {
                    "type": "string",
                    "description": "Country, use country abbreviation. Default US. Options: US, JP, DE"
                  },
                  "priceMin": {
                    "type": "number",
                    "description": "Minimum product price",
                    "example": 1
                  },
                  "priceMax": {
                    "type": "number",
                    "description": "Maximum product price",
                    "example": 1
                  },
                  "totalReviewsMin": {
                    "type": "integer",
                    "description": "Minimum number of reviews",
                    "example": 1
                  },
                  "totalReviewsMax": {
                    "type": "integer",
                    "description": "Maximum number of reviews",
                    "example": 1
                  },
                  "customerRatingMin": {
                    "type": "number",
                    "description": "Minimum rating",
                    "example": 1
                  },
                  "customerRatingMax": {
                    "type": "number",
                    "description": "Maximum rating",
                    "example": 1
                  },
                  "clickConversionRateMin": {
                    "type": "number",
                    "description": "Minimum click-to-purchase conversion rate, value range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "clickConversionRateMax": {
                    "type": "number",
                    "description": "Maximum click-to-purchase conversion rate, value range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "clickConversionRateCompositeMin": {
                    "type": "number",
                    "description": "Minimum composite conversion rate, value range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "clickConversionRateCompositeMax": {
                    "type": "number",
                    "description": "Maximum composite conversion rate, value range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "clickCountT7Min": {
                    "type": "integer",
                    "description": "Minimum weekly click count",
                    "example": 1
                  },
                  "clickCountT7Max": {
                    "type": "integer",
                    "description": "Maximum weekly click count",
                    "example": 1
                  },
                  "clickCountT30Min": {
                    "type": "integer",
                    "description": "Minimum monthly click count",
                    "example": 1
                  },
                  "clickCountT30Max": {
                    "type": "integer",
                    "description": "Maximum monthly click count",
                    "example": 1
                  },
                  "clickCountGrowthT7Min": {
                    "type": "number",
                    "description": "Minimum weekly click growth rate, value range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "clickCountGrowthT7Max": {
                    "type": "number",
                    "description": "Maximum weekly click growth rate, value range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "clickCountGrowthT30Min": {
                    "type": "number",
                    "description": "Minimum monthly click growth rate, value range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "clickCountGrowthT30Max": {
                    "type": "number",
                    "description": "Maximum monthly click growth rate, value range 0-1, 0.1 means 10%",
                    "example": 1
                  },
                  "salesVolumeT360Min": {
                    "type": "integer",
                    "description": "Minimum annual sales volume",
                    "example": 1
                  },
                  "salesVolumeT360Max": {
                    "type": "integer",
                    "description": "Maximum annual sales volume",
                    "example": 1
                  },
                  "grossProfitMarginMin": {
                    "type": "number",
                    "description": "Minimum gross profit margin",
                    "example": 1
                  },
                  "grossProfitMarginMax": {
                    "type": "number",
                    "description": "Maximum gross profit margin",
                    "example": 1
                  },
                  "fbaFeeMin": {
                    "type": "number",
                    "description": "Minimum FBA fee",
                    "example": 1
                  },
                  "fbaFeeMax": {
                    "type": "number",
                    "description": "Maximum FBA fee",
                    "example": 1
                  },
                  "launchDateMin": {
                    "type": "string",
                    "description": "Earliest listing time, format: yyyyMMdd000000",
                    "example": "2026-01-01"
                  },
                  "launchDateMax": {
                    "type": "string",
                    "description": "Latest listing time, format: yyyyMMdd000000",
                    "example": "2026-01-01"
                  },
                  "nicheCountMin": {
                    "type": "integer",
                    "description": "Minimum niche market count",
                    "example": 1
                  },
                  "nicheCountMax": {
                    "type": "integer",
                    "description": "Maximum niche market count",
                    "example": 1
                  },
                  "sellerCountry": {
                    "type": "string",
                    "description": "Seller country/region code, comma-separated for multiple selections, e.g.: CN,US"
                  },
                  "sortField": {
                    "type": "string",
                    "description": "Sort field. Default purchasedClicksT360. Options: totalReviews (total reviews), price (price), launchDate (listing time), clickCountT7 (7-day click count), clickCountT30 (30-day click count), clickCountT90 (90-day click count), clickConversionRate (click-to-purchase conversion rate), clickConversionRateComposite (composite click-to-purchase conversion rate), customerRating (rating), purchasedClicksT360 (360-day purchase clicks), clickCountGrowthT7 (weekly click growth rate), clickCountGrowthT30 (monthly click growth rate), currentPrice (current price), fbaFee (FBA fee), shippingFee (FBA shipping), gpm (gross profit margin)"
                  },
                  "sortType": {
                    "type": "string",
                    "description": "Sort direction. Default desc. Options: desc (descending), asc (ascending)"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number. Default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page (10-100). Default 50",
                    "example": 10
                  }
                },
                "required": [
                  "keyword"
                ],
                "example": {
                  "page": 1,
                  "countryCode": "US",
                  "keyword": "phone case",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "countryCode": "US",
                "keyword": "phone case",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Tool type: Nexscope",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: amazon",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "Amazon product ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "parentAsin": {
                                        "type": "string",
                                        "description": "Amazon product parent ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Price",
                                        "example": 1
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product main image",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Product image URL list",
                                        "example": []
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "ASIN link",
                                        "example": "B072MQ5BRX"
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time (timestamp)",
                                        "example": "2026-01-01"
                                      },
                                      "availableDateString": {
                                        "type": "string",
                                        "description": "Listing date (string)",
                                        "example": "2026-01-01"
                                      },
                                      "categoryNames": {
                                        "type": "array",
                                        "description": "Category information",
                                        "example": []
                                      },
                                      "marketplaceId": {
                                        "type": "string",
                                        "description": "Site ID",
                                        "example": "US"
                                      },
                                      "clickCountT7": {
                                        "type": "integer",
                                        "description": "Weekly click count",
                                        "example": 1
                                      },
                                      "clickCountT30": {
                                        "type": "integer",
                                        "description": "Monthly click count",
                                        "example": 1
                                      },
                                      "clickCountT90": {
                                        "type": "integer",
                                        "description": "Quarterly click count",
                                        "example": 1
                                      },
                                      "clickConversionRate": {
                                        "type": "number",
                                        "description": "Click-to-purchase conversion rate",
                                        "example": 1
                                      },
                                      "clickConversionRateComposite": {
                                        "type": "number",
                                        "description": "Composite conversion rate",
                                        "example": 1
                                      },
                                      "grossProfitMargin": {
                                        "type": "number",
                                        "description": "Gross profit margin",
                                        "example": 1
                                      },
                                      "fbaFee": {
                                        "type": "number",
                                        "description": "Amazon fee",
                                        "example": 1
                                      },
                                      "shippingFee": {
                                        "type": "number",
                                        "description": "FBA shipping fee",
                                        "example": 1
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Tool type: Nexscope",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source type: amazon",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "costToken": 1,
                    "columns": [],
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "parentAsin": "B072MQ5BRX",
                        "price": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "productImageUrls": [],
                        "asinUrl": "B072MQ5BRX",
                        "ratings": 1,
                        "availableDate": "2026-01-01",
                        "availableDateString": "2026-01-01",
                        "categoryNames": [],
                        "marketplaceId": "US",
                        "clickCountT7": 1,
                        "clickCountT30": 1,
                        "clickCountT90": 1,
                        "clickConversionRate": 1,
                        "clickConversionRateComposite": 1,
                        "grossProfitMargin": 1,
                        "fbaFee": 1,
                        "shippingFee": 1
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-product-discovery",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_product_discovery",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-product-history/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Product History",
        "description": "Retrieve Amazon product details by ASIN, including price, title, Item Highlights when available, main image, listing date, material, weight, variant monthly sales, and up to 12 months of monthly sales history. Triggered when users query Amazon product details, ASIN lookup, product pricing, sales rank history, monthly sales trends, product dimensions, FBA fees, product specifications, batch ASIN query, Nexscope product details, ASIN detail lookup, monthly sales data, pricing info, product specifications, FBA fees, batch ASIN query. Even if users do not explicitly mention \"Nexscope\", this skill should be triggered whenever the task involves obtaining structured product data for one or more Amazon ASINs.",
        "operationId": "runAmazonProductHistory",
        "externalDocs": {
          "description": "Amazon Product History documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-product-history"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-product-history.",
                "properties": {
                  "asin": {
                    "type": "string",
                    "description": "Amazon Standard Identification Number (ASIN), multiple ASINs separated by English commas, up to 5, max length 300 characters. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ,B07M68S376",
                    "example": "B072MQ5BRX"
                  },
                  "domain": {
                    "type": "string",
                    "description": "Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil)",
                    "example": "1"
                  },
                  "history": {
                    "type": "integer",
                    "description": "Whether to include historical data and historical sales in the response. 1 = include price history, sales rank, historical sales and other time-series data (sales for previous months), 0 = return only basic product information. Default: 0",
                    "example": 1
                  }
                },
                "required": [
                  "asin",
                  "domain"
                ],
                "example": {
                  "domain": "1",
                  "history": 1,
                  "asin": "B072MQ5BRX"
                },
                "additionalProperties": true
              },
              "example": {
                "domain": "1",
                "history": 1,
                "asin": "B072MQ5BRX"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total rows",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "perPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Items per page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: Nexscope",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "currentPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page number",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "itemHighlights": {
                                        "type": "string",
                                        "description": "Short Item Highlights separate from the title; up to 125 characters and may be null, blank, or absent",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "manufacturer": {
                                        "type": "string",
                                        "description": "Manufacturer",
                                        "example": null
                                      },
                                      "model": {
                                        "type": "string",
                                        "description": "Model",
                                        "example": null
                                      },
                                      "color": {
                                        "type": "string",
                                        "description": "Color",
                                        "example": null
                                      },
                                      "material": {
                                        "type": "string",
                                        "description": "Product material, the primary material used in its construction",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current price (in local currency, e.g., USD/EUR)",
                                        "example": 1
                                      },
                                      "primePrice": {
                                        "type": "number",
                                        "description": "Prime price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Current rating (0.0-5.0, e.g., 4.5 stars)",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Number of ratings",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "salesRank": {
                                        "type": "integer",
                                        "description": "Sales rank",
                                        "example": 1
                                      },
                                      "salesRank30": {
                                        "type": "integer",
                                        "description": "Average sales rank in last 30 days",
                                        "example": 1
                                      },
                                      "salesRank90": {
                                        "type": "integer",
                                        "description": "Average sales rank in last 90 days",
                                        "example": 1
                                      },
                                      "salesRank180": {
                                        "type": "integer",
                                        "description": "Average sales rank in last 180 days",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Monthly sales units",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Monthly sales revenue",
                                        "example": 1
                                      },
                                      "monthlySalesUnits1MonthAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 1 month ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits2MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 2 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits3MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 3 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits4MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 4 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits5MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 5 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits6MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 6 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits7MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 7 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits8MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 8 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits9MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 9 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits10MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 10 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits11MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 11 months ago",
                                        "example": 1
                                      },
                                      "monthlySalesUnits12MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly sales 12 months ago",
                                        "example": 1
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time (yyyy-MM-dd HH:mm:ss)",
                                        "example": "2026-01-01 00:00:00"
                                      },
                                      "lastUpdate": {
                                        "type": "string",
                                        "description": "Last update time (yyyy-MM-dd HH:mm:ss)",
                                        "example": "2026-01-01 00:00:00"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Image URL (request address)",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Product image list",
                                        "example": []
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Amazon ASIN detail page URL",
                                        "example": "https://www.amazon.com/dp/B072MQ5BRX"
                                      },
                                      "urlSlug": {
                                        "type": "string",
                                        "description": "URL slug",
                                        "example": "example-product"
                                      },
                                      "itemLength": {
                                        "type": "integer",
                                        "description": "Item length in millimeters, 0 or -1 if unavailable",
                                        "example": 1
                                      },
                                      "itemWidth": {
                                        "type": "integer",
                                        "description": "Item width in millimeters, 0 or -1 if unavailable",
                                        "example": 1
                                      },
                                      "itemHeight": {
                                        "type": "integer",
                                        "description": "Item height in millimeters, 0 or -1 if unavailable",
                                        "example": 1
                                      },
                                      "dimension": {
                                        "type": "string",
                                        "description": "Dimensions",
                                        "example": null
                                      },
                                      "dimensionsType": {
                                        "type": "string",
                                        "description": "Dimensions type",
                                        "example": null
                                      },
                                      "weight": {
                                        "type": "string",
                                        "description": "Weight (grams)",
                                        "example": null
                                      },
                                      "packageLength": {
                                        "type": "integer",
                                        "description": "Package length (mm)",
                                        "example": 1
                                      },
                                      "packageWidth": {
                                        "type": "integer",
                                        "description": "Package width (mm)",
                                        "example": 1
                                      },
                                      "packageHeight": {
                                        "type": "integer",
                                        "description": "Package height (mm)",
                                        "example": 1
                                      },
                                      "packageWeight": {
                                        "type": "string",
                                        "description": "Package weight (grams)",
                                        "example": null
                                      },
                                      "packageDimensions": {
                                        "type": "string",
                                        "description": "Package dimensions",
                                        "example": null
                                      },
                                      "packageQuantity": {
                                        "type": "integer",
                                        "description": "Quantity of items in the package, 0 or -1 if unavailable",
                                        "example": 1
                                      },
                                      "fulfillment": {
                                        "type": "string",
                                        "description": "Fulfillment method (AMZ, FBA, FBM)",
                                        "example": null
                                      },
                                      "fbaFees": {
                                        "type": "number",
                                        "description": "FBA fulfillment fee (in local currency)",
                                        "example": 1
                                      },
                                      "referralFeePercentage": {
                                        "type": "number",
                                        "description": "Referral fee percentage",
                                        "example": 1
                                      },
                                      "profit": {
                                        "type": "number",
                                        "description": "Profit margin (percentage, e.g., 25.5 means 25.5%)",
                                        "example": 1
                                      },
                                      "buyBoxSellerId": {
                                        "type": "string",
                                        "description": "Buy Box seller ID",
                                        "example": "example-id"
                                      },
                                      "sellerNum": {
                                        "type": "integer",
                                        "description": "Number of sellers",
                                        "example": 1
                                      },
                                      "variationNum": {
                                        "type": "integer",
                                        "description": "Number of variations",
                                        "example": 1
                                      },
                                      "parentAsin": {
                                        "type": "string",
                                        "description": "Parent ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "rootCategory": {
                                        "type": "integer",
                                        "description": "Root category ID",
                                        "example": 1
                                      },
                                      "categoryTree": {
                                        "type": "string",
                                        "description": "Category tree",
                                        "example": null
                                      },
                                      "categoryTreeId": {
                                        "type": "string",
                                        "description": "Category tree ID",
                                        "example": "example-id"
                                      },
                                      "subcategories": {
                                        "type": "array",
                                        "description": "Subcategory list, each element contains code (category ID), rank (ranking), label (category name)",
                                        "example": []
                                      },
                                      "isAdultProduct": {
                                        "type": "boolean",
                                        "description": "Whether it is an adult product",
                                        "example": false
                                      },
                                      "isHazmat": {
                                        "type": "boolean",
                                        "description": "Whether it is hazardous material",
                                        "example": false
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source type: Nexscope",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "perPage": 1,
                    "columns": [],
                    "costToken": 1,
                    "totalCount": 1,
                    "currentPage": 1,
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "price": 1,
                        "primePrice": 1,
                        "rating": 1,
                        "ratings": 1,
                        "reviewCount": 1,
                        "salesRank": 1,
                        "salesRank30": 1,
                        "salesRank90": 1,
                        "salesRank180": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "monthlySalesUnits1MonthAgo": 1,
                        "monthlySalesUnits2MonthsAgo": 1,
                        "monthlySalesUnits3MonthsAgo": 1,
                        "monthlySalesUnits4MonthsAgo": 1,
                        "monthlySalesUnits5MonthsAgo": 1,
                        "monthlySalesUnits6MonthsAgo": 1,
                        "monthlySalesUnits7MonthsAgo": 1,
                        "monthlySalesUnits8MonthsAgo": 1,
                        "monthlySalesUnits9MonthsAgo": 1,
                        "monthlySalesUnits10MonthsAgo": 1,
                        "monthlySalesUnits11MonthsAgo": 1,
                        "monthlySalesUnits12MonthsAgo": 1,
                        "availableDate": "2026-01-01 00:00:00",
                        "lastUpdate": "2026-01-01 00:00:00",
                        "imageUrl": "https://example.com/image.jpg",
                        "productImageUrls": [],
                        "asinUrl": "https://www.amazon.com/dp/B072MQ5BRX",
                        "urlSlug": "example-product",
                        "itemLength": 1,
                        "itemWidth": 1,
                        "itemHeight": 1,
                        "packageLength": 1,
                        "packageWidth": 1,
                        "packageHeight": 1,
                        "packageQuantity": 1,
                        "fbaFees": 1,
                        "referralFeePercentage": 1,
                        "profit": 1,
                        "buyBoxSellerId": "example-id",
                        "sellerNum": 1,
                        "variationNum": 1,
                        "parentAsin": "B072MQ5BRX",
                        "rootCategory": 1,
                        "categoryTreeId": "example-id",
                        "subcategories": [],
                        "isAdultProduct": false,
                        "isHazmat": false
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-product-history",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_product_history",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-product-price-series/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Product Price Series",
        "description": "Query Amazon product historical time-series data, including price trends, BSR (Best Sellers Rank) trends, rating changes, seller counts, and monthly sales, supporting any ASIN across multiple Amazon marketplaces. Triggered when users mention price history, price tracking, BSR history, BSR trends, historical pricing, price fluctuations, Nexscope data, rank history, price drop alerts, lightning deal historical prices, Buy Box price trends, coupon prices, FBA/FBM price comparison, seller count changes, rating trends, sales history. Even if users do not explicitly mention \"Nexscope\" or \"time-series data\", this skill should be triggered whenever the task involves analyzing Amazon product-level historical data (such as price, rank, or sales trends over time).",
        "operationId": "runAmazonProductPriceSeries",
        "externalDocs": {
          "description": "Amazon Product Price Series documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-product-price-series"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-product-price-series.",
                "properties": {
                  "asin": {
                    "type": "string",
                    "description": "Amazon Standard Identification Number (ASIN), single ASIN only, max length 1000",
                    "example": "B072MQ5BRX"
                  },
                  "domain": {
                    "type": "string",
                    "description": "Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil)",
                    "example": "1"
                  },
                  "days": {
                    "type": "integer",
                    "description": "Limit historical data to this many days, default 90, max 365",
                    "example": 30
                  },
                  "showPrice": {
                    "type": "integer",
                    "description": "Set to 1 to return the lowest new price curve in the market",
                    "example": 1
                  },
                  "showPriceList": {
                    "type": "integer",
                    "description": "Set to 1 to return the list/strikethrough price curve",
                    "example": 1
                  },
                  "showPriceDeal": {
                    "type": "integer",
                    "description": "Set to 1 to return the deal/flash sale price curve",
                    "example": 1
                  },
                  "showPricePrime": {
                    "type": "integer",
                    "description": "Set to 1 to return the Prime-exclusive new price curve",
                    "example": 1
                  },
                  "showPriceFba": {
                    "type": "integer",
                    "description": "Set to 1 to return the third-party FBA new price curve",
                    "example": 1
                  },
                  "showPriceFbm": {
                    "type": "integer",
                    "description": "Set to 1 to return the third-party FBM new price curve",
                    "example": 1
                  },
                  "showPriceCoupon": {
                    "type": "integer",
                    "description": "Set to 1 to return the coupon-applied Buy Box price curve",
                    "example": 1
                  },
                  "showBsrMain": {
                    "type": "integer",
                    "description": "Set to 1 to return the main category BSR curve",
                    "example": 1
                  },
                  "showSellerCount": {
                    "type": "integer",
                    "description": "Set to 1 to return the seller count curve",
                    "example": 1
                  }
                },
                "required": [
                  "asin",
                  "domain"
                ],
                "example": {
                  "showPricePrime": 1,
                  "showPriceList": 1,
                  "domain": "1",
                  "showPriceDeal": 1,
                  "days": 30,
                  "asin": "B072MQ5BRX",
                  "showPrice": 1
                },
                "additionalProperties": true
              },
              "example": {
                "showPricePrime": 1,
                "showPriceList": 1,
                "domain": "1",
                "showPriceDeal": 1,
                "days": 30,
                "asin": "B072MQ5BRX",
                "showPrice": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "asin": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "ASIN",
                                  "example": "B072MQ5BRX"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "buyboxPrice": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Buy Box price (time=timestamp, value=Buy Box price)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "price": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Price (time=timestamp, value=price)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "priceList": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "List/strikethrough price (time=timestamp, value=list price)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "priceDeal": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Deal price (time=timestamp, value=deal price)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pricePrime": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Prime price (time=timestamp, value=Prime price)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "priceFba": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "FBA price (time=timestamp, value=FBA price)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "priceFbm": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "FBM price (time=timestamp, value=FBM price)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "priceCoupon": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Coupon price (time=timestamp, value=coupon price)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "bsrMain": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Main category BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "bsrSub": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Subcategory BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sellerCount": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Seller count (time=timestamp, value=seller count)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rating": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rating (time=timestamp, value=rating)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "ratingCount": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rating count (time=timestamp, value=rating count)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "monthlySold": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Child ASIN sales (time=timestamp, value=sales units)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "asin": "B072MQ5BRX",
                    "buyboxPrice": [],
                    "price": [],
                    "priceList": [],
                    "priceDeal": [],
                    "pricePrime": [],
                    "priceFba": [],
                    "priceFbm": [],
                    "priceCoupon": [],
                    "bsrMain": [],
                    "bsrSub": [],
                    "sellerCount": [],
                    "rating": [],
                    "ratingCount": [],
                    "monthlySold": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-product-price-series",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_product_price_series",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-product-research/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Product Research Directory",
        "description": "Use this directory to find the concrete API for a research goal. It returns links and typical inputs; invoke the linked API for the actual research data.",
        "operationId": "runAmazonProductResearch",
        "externalDocs": {
          "description": "Amazon Product Research Directory documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-product-research"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Optional category filter. Use all to list every original Amazon product-research operation.",
                "properties": {
                  "goal": {
                    "type": "string",
                    "description": "Optional filter: all, search, detail, reviews, image-search, opportunity, keyword, price-history, or sales-estimates.",
                    "example": "all"
                  }
                },
                "example": {
                  "goal": "all"
                },
                "additionalProperties": true
              },
              "example": {
                "goal": "all"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "directoryType": {
                              "type": "string",
                              "description": "Identifies this response as an API directory, not a research result.",
                              "example": "amazon-product-research-directory"
                            },
                            "goal": {
                              "type": "string",
                              "description": "Applied directory filter.",
                              "example": "all"
                            },
                            "count": {
                              "type": "integer",
                              "description": "Number of concrete API entries returned.",
                              "example": 33
                            },
                            "recommendedApis": {
                              "type": "array",
                              "description": "Concrete APIs that execute the selected research operation.",
                              "example": [],
                              "items": {
                                "type": "object",
                                "properties": {
                                  "operation": {
                                    "type": "string",
                                    "description": "Original Skill operation name.",
                                    "example": "amazon_search"
                                  },
                                  "slug": {
                                    "type": "string",
                                    "description": "Concrete Skill API slug to invoke.",
                                    "example": "amazon-search"
                                  },
                                  "endpoint": {
                                    "type": "string",
                                    "description": "Concrete Skill API run endpoint.",
                                    "example": "/api/skill-api/v1/skills/amazon-search/run"
                                  },
                                  "reason": {
                                    "type": "string",
                                    "description": "What the concrete API executes.",
                                    "example": "Search Amazon storefront results by keyword."
                                  },
                                  "typicalFields": {
                                    "type": "array",
                                    "description": "Typical inputs for navigation; the linked API schema is authoritative.",
                                    "example": [
                                      "keyword",
                                      "marketplace"
                                    ]
                                  },
                                  "requestExample": {
                                    "type": "object",
                                    "description": "Example request for the concrete API.",
                                    "example": {
                                      "keyword": "wireless speaker",
                                      "marketplace": "US"
                                    }
                                  }
                                },
                                "required": [
                                  "operation",
                                  "slug",
                                  "endpoint",
                                  "reason",
                                  "typicalFields",
                                  "requestExample"
                                ]
                              }
                            },
                            "usage": {
                              "type": "string",
                              "description": "Next step for callers.",
                              "example": "Invoke one recommended API directly for the actual research result."
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "directoryType",
                            "goal",
                            "count",
                            "recommendedApis",
                            "usage"
                          ],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "directoryType": "amazon-product-research-directory",
                    "goal": "all",
                    "count": 33,
                    "recommendedApis": [
                      {
                        "requestExample": {
                          "keyword": "wireless speaker",
                          "marketplace": "US"
                        },
                        "typicalFields": [
                          "keyword",
                          "marketplace"
                        ],
                        "operation": "amazon_search",
                        "slug": "amazon-search",
                        "endpoint": "/api/skill-api/v1/skills/amazon-search/run",
                        "reason": "Search Amazon storefront results by keyword."
                      },
                      {
                        "requestExample": {
                          "keyword": "wireless speaker",
                          "marketplace": "US"
                        },
                        "typicalFields": [
                          "keyword",
                          "marketplace"
                        ],
                        "operation": "amazon_alexa_search",
                        "slug": "amazon-alexa-search",
                        "endpoint": "/api/skill-api/v1/skills/amazon-alexa-search/run",
                        "reason": "Search Amazon Alexa ranking and product results."
                      }
                    ],
                    "usage": "Invoke one recommended API directly for the actual research result."
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-product-research",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_product_research",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-related-asins/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Related Asins",
        "description": "Find Amazon same-niche competitors by ASIN, with multi-dimensional filtering by click conversion rate, composite conversion rate, click volume, sales volume, reviews, ratings, price, and gross margin to identify potential competitors. Triggered when users mention same-niche competitors, ASIN competitor mining, niche competitor analysis, similar product benchmarking, ASIN benchmarking, niche market competitor list, high-conversion competitor screening, Nexscope product mining, niche competitor by ASIN, ASIN competitor analysis, same niche products, similar products discovery, conversion rate comparison, potential competitor screening, Nexscope ASIN mining. Even if users do not explicitly mention \"niche\" or \"same niche\", this skill should be triggered whenever the task involves discovering competitor lists or screening potential competitors based on a specific ASIN within the same market segment.",
        "operationId": "runAmazonRelatedAsins",
        "externalDocs": {
          "description": "Amazon Related Asins documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-related-asins"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-related-asins.",
                "properties": {
                  "asin": {
                    "type": "string",
                    "description": "Reference ASIN, used to query competitor listings that belong to the same niche as this ASIN, max length 1000 characters",
                    "example": "B072MQ5BRX"
                  },
                  "countryCode": {
                    "type": "string",
                    "description": "Country code, options: US (United States), JP (Japan), DE (Germany)"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items returned per page (10-100)",
                    "example": 10
                  },
                  "sortField": {
                    "type": "string",
                    "description": "Sort field (see sort options below)"
                  },
                  "sortType": {
                    "type": "string",
                    "description": "Sort direction: desc (descending) or asc (ascending)"
                  },
                  "priceMin": {
                    "type": "number",
                    "description": "Minimum product price",
                    "example": 1
                  },
                  "priceMax": {
                    "type": "number",
                    "description": "Maximum product price",
                    "example": 1
                  },
                  "fbaFeeMin": {
                    "type": "number",
                    "description": "Minimum FBA fee",
                    "example": 1
                  },
                  "fbaFeeMax": {
                    "type": "number",
                    "description": "Maximum FBA fee",
                    "example": 1
                  },
                  "grossProfitMarginMin": {
                    "type": "number",
                    "description": "Minimum gross profit margin",
                    "example": 1
                  },
                  "grossProfitMarginMax": {
                    "type": "number",
                    "description": "Maximum gross profit margin",
                    "example": 1
                  },
                  "totalReviewsMin": {
                    "type": "integer",
                    "description": "Minimum review count",
                    "example": 1
                  },
                  "totalReviewsMax": {
                    "type": "integer",
                    "description": "Maximum review count",
                    "example": 1
                  },
                  "customerRatingMin": {
                    "type": "number",
                    "description": "Minimum rating, range 0.0-5.0",
                    "example": 1
                  },
                  "customerRatingMax": {
                    "type": "number",
                    "description": "Maximum rating, range 0.0-5.0",
                    "example": 1
                  },
                  "clickCountT7Min": {
                    "type": "integer",
                    "description": "Minimum weekly click count",
                    "example": 1
                  },
                  "clickCountT7Max": {
                    "type": "integer",
                    "description": "Maximum weekly click count",
                    "example": 1
                  },
                  "clickCountGrowthT7Min": {
                    "type": "number",
                    "description": "Minimum weekly click growth rate, range 0-1, e.g., 0.1 means 10%",
                    "example": 1
                  },
                  "clickCountGrowthT7Max": {
                    "type": "number",
                    "description": "Maximum weekly click growth rate, range 0-1, e.g., 0.1 means 10%",
                    "example": 1
                  },
                  "clickConversionRateMin": {
                    "type": "number",
                    "description": "Minimum click conversion rate, range 0-1, e.g., 0.1 means 10%",
                    "example": 1
                  },
                  "clickConversionRateMax": {
                    "type": "number",
                    "description": "Maximum click conversion rate, range 0-1, e.g., 0.1 means 10%",
                    "example": 1
                  },
                  "clickCountT30Min": {
                    "type": "integer",
                    "description": "Minimum monthly click count",
                    "example": 1
                  },
                  "clickCountT30Max": {
                    "type": "integer",
                    "description": "Maximum monthly click count",
                    "example": 1
                  },
                  "clickCountGrowthT30Min": {
                    "type": "number",
                    "description": "Minimum monthly click growth rate, range 0-1, e.g., 0.1 means 10%",
                    "example": 1
                  },
                  "clickCountGrowthT30Max": {
                    "type": "number",
                    "description": "Maximum monthly click growth rate, range 0-1, e.g., 0.1 means 10%",
                    "example": 1
                  },
                  "clickConversionRateCompositeMin": {
                    "type": "number",
                    "description": "Minimum composite click conversion rate, range 0-1, e.g., 0.1 means 10%",
                    "example": 1
                  },
                  "clickConversionRateCompositeMax": {
                    "type": "number",
                    "description": "Maximum composite click conversion rate, range 0-1, e.g., 0.1 means 10%",
                    "example": 1
                  },
                  "salesVolumeT360Min": {
                    "type": "integer",
                    "description": "Minimum annual sales volume",
                    "example": 1
                  },
                  "salesVolumeT360Max": {
                    "type": "integer",
                    "description": "Maximum annual sales volume",
                    "example": 1
                  },
                  "launchDateMin": {
                    "type": "string",
                    "description": "Earliest listing time, format yyyyMMdd000000",
                    "example": "2026-01-01"
                  },
                  "launchDateMax": {
                    "type": "string",
                    "description": "Latest listing time, format yyyyMMdd000000",
                    "example": "2026-01-01"
                  },
                  "nicheCountMin": {
                    "type": "integer",
                    "description": "Minimum number of niche markets",
                    "example": 1
                  },
                  "nicheCountMax": {
                    "type": "integer",
                    "description": "Maximum number of niche markets",
                    "example": 1
                  },
                  "sellerCountry": {
                    "type": "string",
                    "description": "Seller country code, comma-separated for multiple countries, e.g.: CN,US"
                  }
                },
                "required": [
                  "asin"
                ],
                "example": {
                  "asin": "B072MQ5BRX",
                  "countryCode": "US",
                  "pageSize": 10,
                  "page": 1
                },
                "additionalProperties": true
              },
              "example": {
                "asin": "B072MQ5BRX",
                "countryCode": "US",
                "pageSize": 10,
                "page": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pages": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size, min 10, max 100",
                                  "example": 10
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "ASIN product list (see product object fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "Amazon product ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "parentAsin": {
                                        "type": "string",
                                        "description": "Amazon product parent ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Price",
                                        "example": 1
                                      },
                                      "currentPrice": {
                                        "type": "number",
                                        "description": "Current price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "customerRating": {
                                        "type": "number",
                                        "description": "Rating",
                                        "example": 1
                                      },
                                      "totalReviews": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "launchDate": {
                                        "type": "string",
                                        "description": "Listing time",
                                        "example": "2026-01-01"
                                      },
                                      "link": {
                                        "type": "string",
                                        "description": "ASIN link",
                                        "example": null
                                      },
                                      "imagesUrl": {
                                        "type": "string",
                                        "description": "Product main image",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "string",
                                        "description": "Seller ID",
                                        "example": "example-id"
                                      },
                                      "fbaFee": {
                                        "type": "number",
                                        "description": "FBA fee",
                                        "example": 1
                                      },
                                      "shippingFee": {
                                        "type": "number",
                                        "description": "FBA shipping fee",
                                        "example": 1
                                      },
                                      "gpm": {
                                        "type": "number",
                                        "description": "Gross profit margin",
                                        "example": 1
                                      },
                                      "clickConversionRate": {
                                        "type": "number",
                                        "description": "Click conversion rate (original 7-day click conversion rate)",
                                        "example": 1
                                      },
                                      "clickConversionRateComposite": {
                                        "type": "number",
                                        "description": "Composite click conversion rate",
                                        "example": 1
                                      },
                                      "clickConversionRateType": {
                                        "type": "string",
                                        "description": "Conversion rate calculation type",
                                        "example": null
                                      },
                                      "clickConversionRateCompositeType": {
                                        "type": "string",
                                        "description": "Composite conversion rate calculation type",
                                        "example": null
                                      },
                                      "clickCountT7": {
                                        "type": "integer",
                                        "description": "7-day click count",
                                        "example": 1
                                      },
                                      "clickCountT30": {
                                        "type": "integer",
                                        "description": "30-day click count",
                                        "example": 1
                                      },
                                      "clickCountT90": {
                                        "type": "integer",
                                        "description": "90-day click count",
                                        "example": 1
                                      },
                                      "clickCountGrowthT7": {
                                        "type": "number",
                                        "description": "Weekly click growth rate",
                                        "example": 1
                                      },
                                      "clickCountGrowthT30": {
                                        "type": "number",
                                        "description": "Monthly click growth rate",
                                        "example": 1
                                      },
                                      "purchasedClicksT360": {
                                        "type": "integer",
                                        "description": "360-day purchase clicks",
                                        "example": 1
                                      },
                                      "salesVolumeT360": {
                                        "type": "integer",
                                        "description": "Annual sales volume",
                                        "example": 1
                                      },
                                      "nicheCount": {
                                        "type": "integer",
                                        "description": "Number of niche markets the product belongs to",
                                        "example": 1
                                      },
                                      "sameNicheTitle": {
                                        "type": "string",
                                        "description": "Same niche title",
                                        "example": null
                                      },
                                      "involvedNum": {
                                        "type": "integer",
                                        "description": "Number of involved keywords",
                                        "example": 1
                                      },
                                      "involvedFrequency": {
                                        "type": "integer",
                                        "description": "Frequency of involved keywords",
                                        "example": 1
                                      },
                                      "categoryNames": {
                                        "type": "array",
                                        "description": "Category information",
                                        "example": []
                                      },
                                      "hasMetric": {
                                        "type": "boolean",
                                        "description": "Whether the product has metrics",
                                        "example": false
                                      },
                                      "searchValueType": {
                                        "type": "string",
                                        "description": "Search type: exact (exact match), sameNiche (same niche as reference ASIN), category (category)",
                                        "example": null
                                      },
                                      "niches": {
                                        "type": "array",
                                        "description": "Top 3 niche markets, containing: nicheId, nicheTitle, demand (market score), image, marketplaceId",
                                        "example": []
                                      },
                                      "bestSellersRanking": {
                                        "type": "array",
                                        "description": "Best seller rankings, containing: rank (ranking), category (category name)",
                                        "example": []
                                      },
                                      "trends": {
                                        "type": "array",
                                        "description": "90-day trend data, containing: day (date), clickCountT7 (weekly click count), reviewCount (review count), reviewRating (review rating), bestSellerRanking (BSR ranking), averagePriceT7 (weekly average price), totalOfferDepthT7 (7-day new offers)",
                                        "example": []
                                      },
                                      "lastUpdateTime": {
                                        "type": "string",
                                        "description": "Last update time",
                                        "example": "2026-01-01"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "pages": 1,
                    "page": 1,
                    "pageSize": 10,
                    "data": [
                      {
                        "asin": "B072MQ5BRX",
                        "parentAsin": "B072MQ5BRX",
                        "price": 1,
                        "currentPrice": 1,
                        "customerRating": 1,
                        "totalReviews": 1,
                        "launchDate": "2026-01-01",
                        "imagesUrl": "https://example.com/image.jpg",
                        "sellerId": "example-id",
                        "fbaFee": 1,
                        "shippingFee": 1,
                        "gpm": 1,
                        "clickConversionRate": 1,
                        "clickConversionRateComposite": 1,
                        "clickCountT7": 1,
                        "clickCountT30": 1,
                        "clickCountT90": 1,
                        "clickCountGrowthT7": 1,
                        "clickCountGrowthT30": 1,
                        "purchasedClicksT360": 1,
                        "salesVolumeT360": 1,
                        "nicheCount": 1,
                        "involvedNum": 1,
                        "involvedFrequency": 1,
                        "categoryNames": [],
                        "hasMetric": false,
                        "niches": [],
                        "bestSellersRanking": [],
                        "trends": [],
                        "lastUpdateTime": "2026-01-01"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-related-asins",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_related_asins",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-reviews-list/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Reviews List",
        "description": "Fetch and analyze Amazon product reviews by ASIN, supporting 15 marketplaces (including US) with star rating filtering. Triggered when users mention Amazon reviews, US reviews, product reviews, buyer complaints, negative reviews, positive reviews, star ratings, review analysis, review sentiment, product improvement suggestions, Vine reviews, verified purchase reviews, competitor review research, Amazon reviews, US reviews, Amazon.com reviews, product feedback, negative review analysis, positive review analysis, star rating filter, review sentiment analysis, product improvement insights, Vine reviews, competitor reviews, customer feedback. Even if users do not explicitly say \"reviews\", this skill should be triggered whenever the task involves reading, filtering, or analyzing Amazon product customer reviews.",
        "operationId": "runAmazonReviewsList",
        "externalDocs": {
          "description": "Amazon Reviews List documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-reviews-list"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-reviews-list.",
                "properties": {
                  "asin": {
                    "type": "string",
                    "description": "Amazon product ASIN",
                    "example": "B072MQ5BRX"
                  },
                  "domainCode": {
                    "type": "string",
                    "description": "Amazon domain code, default com. Options: com, ca, co.uk, in, de, fr, it, es, co.jp, com.au, com.br, nl, se, com.mx, ae. Use com for the US site"
                  },
                  "star1Num": {
                    "type": "integer",
                    "description": "Number of 1-star reviews, default 10, max 100",
                    "example": 1
                  },
                  "star2Num": {
                    "type": "integer",
                    "description": "Number of 2-star reviews, default 10, max 100",
                    "example": 1
                  },
                  "star3Num": {
                    "type": "integer",
                    "description": "Number of 3-star reviews, default 10, max 100",
                    "example": 1
                  },
                  "star4Num": {
                    "type": "integer",
                    "description": "Number of 4-star reviews, default 10, max 100",
                    "example": 1
                  },
                  "star5Num": {
                    "type": "integer",
                    "description": "Number of 5-star reviews, default 10, max 100",
                    "example": 1
                  },
                  "filterByKeyword": {
                    "type": "string",
                    "description": "Filter reviews by keyword, max length 1000 characters",
                    "example": "phone case"
                  },
                  "sortBy": {
                    "type": "string",
                    "description": "Review sort order: recent (most recent reviews) or helpful (most helpful reviews), default recent"
                  },
                  "reviewerType": {
                    "type": "string",
                    "description": "Reviewer type: all_reviews (all reviews) or avp_only_reviews (verified purchases only), default all_reviews"
                  },
                  "mediaType": {
                    "type": "string",
                    "description": "Media type: all_contents (all content) or media_reviews_only (reviews with media only), default all_contents"
                  },
                  "formatType": {
                    "type": "string",
                    "description": "Format type: all_formats (all formats) or current_format (current format), default all_formats"
                  }
                },
                "required": [
                  "asin"
                ],
                "example": {
                  "star4Num": 1,
                  "domainCode": "com",
                  "asin": "B072MQ5BRX",
                  "star5Num": 1,
                  "star1Num": 1,
                  "star2Num": 1,
                  "star3Num": 1
                },
                "additionalProperties": true
              },
              "example": {
                "star4Num": 1,
                "domainCode": "com",
                "asin": "B072MQ5BRX",
                "star5Num": 1,
                "star1Num": 1,
                "star2Num": 1,
                "star3Num": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total review count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Review list (see review object below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "reviewId": {
                                        "type": "string",
                                        "description": "Review ID",
                                        "example": "example-id"
                                      },
                                      "asin": {
                                        "type": "string",
                                        "description": "Product ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Review title",
                                        "example": null
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "Review content",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "string",
                                        "description": "Rating",
                                        "example": null
                                      },
                                      "date": {
                                        "type": "string",
                                        "description": "Review date",
                                        "example": "2026-01-01"
                                      },
                                      "userName": {
                                        "type": "string",
                                        "description": "Reviewer name",
                                        "example": null
                                      },
                                      "verified": {
                                        "type": "boolean",
                                        "description": "Whether verified purchase",
                                        "example": false
                                      },
                                      "vine": {
                                        "type": "boolean",
                                        "description": "Whether Vine Voice review",
                                        "example": false
                                      },
                                      "numberOfHelpful": {
                                        "type": "integer",
                                        "description": "Helpful count",
                                        "example": 1
                                      },
                                      "imageUrlList": {
                                        "type": "array",
                                        "description": "Review image list",
                                        "example": []
                                      },
                                      "videoUrlList": {
                                        "type": "array",
                                        "description": "Review video list",
                                        "example": []
                                      },
                                      "domainCode": {
                                        "type": "string",
                                        "description": "Country code",
                                        "example": null
                                      },
                                      "productTitle": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "productRating": {
                                        "type": "string",
                                        "description": "Product rating",
                                        "example": null
                                      },
                                      "countRatings": {
                                        "type": "integer",
                                        "description": "Product rating count",
                                        "example": 1
                                      },
                                      "countReviews": {
                                        "type": "integer",
                                        "description": "Product review count",
                                        "example": 1
                                      },
                                      "variationId": {
                                        "type": "string",
                                        "description": "Variation ID",
                                        "example": "example-id"
                                      },
                                      "variationList": {
                                        "type": "array",
                                        "description": "Variation list",
                                        "example": []
                                      },
                                      "profilePath": {
                                        "type": "string",
                                        "description": "Reviewer profile path",
                                        "example": null
                                      },
                                      "currentPage": {
                                        "type": "integer",
                                        "description": "Current page number",
                                        "example": 1
                                      },
                                      "sortStrategy": {
                                        "type": "string",
                                        "description": "Sort strategy",
                                        "example": null
                                      },
                                      "statusCode": {
                                        "type": "integer",
                                        "description": "Status code",
                                        "example": 1
                                      },
                                      "statusMessage": {
                                        "type": "string",
                                        "description": "Status message",
                                        "example": null
                                      },
                                      "locale": {
                                        "type": "object",
                                        "description": "Locale information",
                                        "example": {}
                                      },
                                      "reviewSummary": {
                                        "type": "object",
                                        "description": "Review summary data",
                                        "example": {}
                                      },
                                      "filters": {
                                        "type": "object",
                                        "description": "Applied filter conditions",
                                        "example": {}
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "reviewId": "example-id",
                        "asin": "B072MQ5BRX",
                        "date": "2026-01-01",
                        "verified": false,
                        "vine": false,
                        "numberOfHelpful": 1,
                        "imageUrlList": [],
                        "videoUrlList": [],
                        "countRatings": 1,
                        "countReviews": 1,
                        "variationId": "example-id",
                        "variationList": [],
                        "currentPage": 1,
                        "statusCode": 1,
                        "locale": {},
                        "reviewSummary": {},
                        "filters": {}
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-reviews-list",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_reviews_list",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-sales-estimates/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Sales Estimates",
        "description": "Nexscope ASIN sales estimates query, returning daily estimated sales and latest known price for a specified ASIN over a given time period, covering 10 marketplaces including US, UK, Germany, and Japan. Triggered when users mention ASIN sales estimates, ASIN daily sales, sales estimation, competitor sales monitoring, average daily sales, sales trends, product sales tracking, Nexscope sales data, sales estimates, daily sales, estimated units sold, ASIN sales tracking, competitor sales monitoring, product sales trend, daily unit sales. Even if users do not explicitly mention \"Nexscope\", this skill should be triggered whenever the task involves viewing daily estimated sales data for an Amazon ASIN over a time period.",
        "operationId": "runAmazonSalesEstimates",
        "externalDocs": {
          "description": "Amazon Sales Estimates documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-sales-estimates"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-sales-estimates.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp",
                    "example": "us"
                  },
                  "asin": {
                    "type": "string",
                    "description": "Amazon ASIN to query",
                    "example": "B072MQ5BRX"
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Start date (format: YYYY-MM-DD)",
                    "example": "2026-01-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "End date (format: YYYY-MM-DD); must be earlier than the current date",
                    "example": "2026-01-01"
                  }
                },
                "required": [
                  "marketplace",
                  "asin",
                  "startDate",
                  "endDate"
                ],
                "example": {
                  "asin": "B072MQ5BRX",
                  "marketplace": "us",
                  "endDate": "2026-01-01",
                  "startDate": "2026-01-01"
                },
                "additionalProperties": true
              },
              "example": {
                "asin": "B072MQ5BRX",
                "marketplace": "us",
                "endDate": "2026-01-01",
                "startDate": "2026-01-01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "salesEstimateList": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Sales estimate result list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "Queried ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "id": {
                                        "type": "string",
                                        "description": "Data point identifier",
                                        "example": "example-id"
                                      },
                                      "type": {
                                        "type": "string",
                                        "description": "Resource type, fixed value sales_estimate_result",
                                        "example": null
                                      },
                                      "parentAsin": {
                                        "type": "string",
                                        "description": "Parent ASIN (returned for variant scenarios)",
                                        "example": "B072MQ5BRX"
                                      },
                                      "isParent": {
                                        "type": "boolean",
                                        "description": "Whether it is a parent listing",
                                        "example": false
                                      },
                                      "isVariant": {
                                        "type": "boolean",
                                        "description": "Whether it is a variant listing",
                                        "example": false
                                      },
                                      "isStandalone": {
                                        "type": "boolean",
                                        "description": "Whether it is a standalone listing (non-variant)",
                                        "example": false
                                      },
                                      "variants": {
                                        "type": "array",
                                        "description": "Array of variant ASINs under this parent",
                                        "example": []
                                      },
                                      "dailyEstimates": {
                                        "type": "array",
                                        "description": "Array of daily estimate data",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "date": {
                                              "type": "string",
                                              "description": "Data date (YYYY-MM-DD)",
                                              "example": "2026-01-01"
                                            },
                                            "estimatedUnitsSold": {
                                              "type": "integer",
                                              "description": "Estimated units sold on that day",
                                              "example": 1
                                            },
                                            "lastKnownPrice": {
                                              "type": "number",
                                              "description": "Last known price (USD)",
                                              "example": 1
                                            }
                                          }
                                        }
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "costToken": 1,
                    "salesEstimateList": [
                      {
                        "asin": "B072MQ5BRX",
                        "id": "example-id",
                        "parentAsin": "B072MQ5BRX",
                        "isParent": false,
                        "isVariant": false,
                        "isStandalone": false,
                        "variants": [],
                        "dailyEstimates": [
                          {
                            "date": "2026-01-01",
                            "estimatedUnitsSold": 1,
                            "lastKnownPrice": 1
                          }
                        ]
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-sales-estimates",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_sales_estimates",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-search/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Search",
        "description": "Simulates a real user searching on Amazon's storefront to get real-time keyword ranking and search results page data. Use when the user mentions Amazon product search, search result scraping, keyword ranking on search pages, ASIN ranking position check, competitor discovery, search page price comparison, sponsored product analysis, new product monitoring, or storefront search simulation. Even if the user does not explicitly mention \"search simulation\", trigger this skill whenever their need involves real-time Amazon search results, product ranking data, or storefront SERP analysis.",
        "operationId": "runAmazonSearch",
        "externalDocs": {
          "description": "Amazon Search documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-search.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Keyword; please translate to the language of the target country whenever possible, e.g., use English keywords for the US, German keywords for Germany, etc. (max length 1024)",
                    "example": "phone case"
                  },
                  "amazonDomain": {
                    "type": "string",
                    "description": "Amazon country site, default amazon.com"
                  },
                  "node": {
                    "type": "string",
                    "description": "Amazon category node (max length 1000)"
                  },
                  "language": {
                    "type": "string",
                    "description": "Language/region code, e.g., en_US, de_DE, ja_JP, fr_FR (max length 1000)"
                  },
                  "sort": {
                    "type": "string",
                    "description": "Sort order: relevanceblender (Featured, default), price-asc-rank (Price low to high), price-desc-rank (Price high to low), review-rank (Avg. customer review), date-desc-rank (Newest arrivals), exact-aware-popularity-rank (Best sellers)"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1, ~20 items per page), default 1",
                    "example": 1
                  },
                  "deliveryZip": {
                    "type": "string",
                    "description": "Delivery zip code, used to simulate Amazon frontend address. It is recommended to use commonly used zip codes for major cities in the target country, e.g., New York zip code 10001 for the US site (max length 1000)"
                  },
                  "device": {
                    "type": "string",
                    "description": "Device type: desktop, mobile, tablet, default desktop (max length 1000)"
                  }
                },
                "example": {
                  "page": 1,
                  "keyword": "phone case"
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "phone case"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total rows",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "keyword": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Search keyword",
                                  "example": "phone case"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Search result list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Title",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Price",
                                        "example": 1
                                      },
                                      "extractedPrice": {
                                        "type": "number",
                                        "description": "Parsed price",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "Strikethrough price",
                                        "example": 1
                                      },
                                      "extractedOldPrice": {
                                        "type": "number",
                                        "description": "Parsed strikethrough price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "priceUnit": {
                                        "type": "string",
                                        "description": "Price unit",
                                        "example": null
                                      },
                                      "extractedPriceUnit": {
                                        "type": "number",
                                        "description": "Parsed price unit",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Number of ratings",
                                        "example": 1
                                      },
                                      "position": {
                                        "type": "integer",
                                        "description": "Position",
                                        "example": 1
                                      },
                                      "sponsored": {
                                        "type": "boolean",
                                        "description": "Whether sponsored",
                                        "example": false
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Thumbnail",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Product link",
                                        "example": "https://www.amazon.com/dp/B072MQ5BRX"
                                      },
                                      "delivery": {
                                        "type": "string",
                                        "description": "Delivery information",
                                        "example": null
                                      },
                                      "fulfillment": {
                                        "type": "string",
                                        "description": "Fulfillment information (e.g., FBA)",
                                        "example": null
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time",
                                        "example": "2026-01-01"
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Monthly sales units",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "string",
                                        "description": "Monthly sales revenue",
                                        "example": null
                                      },
                                      "sellerNation": {
                                        "type": "string",
                                        "description": "Seller nationality",
                                        "example": null
                                      },
                                      "dimension": {
                                        "type": "string",
                                        "description": "Dimensions",
                                        "example": null
                                      },
                                      "weight": {
                                        "type": "string",
                                        "description": "Weight",
                                        "example": null
                                      },
                                      "options": {
                                        "type": "string",
                                        "description": "Options",
                                        "example": null
                                      },
                                      "offers": {
                                        "type": "string",
                                        "description": "Offer information",
                                        "example": null
                                      },
                                      "badges": {
                                        "type": "string",
                                        "description": "Amazon frontend search badges",
                                        "example": null
                                      },
                                      "tags": {
                                        "type": "string",
                                        "description": "Tags",
                                        "example": null
                                      },
                                      "snapEbtEligible": {
                                        "type": "boolean",
                                        "description": "SNAP/EBT eligibility",
                                        "example": false
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source type: amazon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      },
                                      "keyword": {
                                        "type": "string",
                                        "description": "Keyword",
                                        "example": "phone case"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "keyword": "phone case",
                    "columns": [],
                    "costToken": 1,
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "price": 1,
                        "extractedPrice": 1,
                        "oldPrice": 1,
                        "extractedOldPrice": 1,
                        "extractedPriceUnit": 1,
                        "rating": 1,
                        "ratings": 1,
                        "position": 1,
                        "sponsored": false,
                        "imageUrl": "https://example.com/image.jpg",
                        "asinUrl": "https://www.amazon.com/dp/B072MQ5BRX",
                        "availableDate": "2026-01-01",
                        "monthlySalesUnits": 1,
                        "snapEbtEligible": false,
                        "keyword": "phone case"
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-search",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-search-by-image/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Search By Image",
        "description": "Perform image-based visual product search on Amazon across 8 marketplaces. Use an image URL to find visually similar products, with optional Nexscope enrichment for sales data. Triggered when users mention Amazon image search, Amazon visual search, find similar products on Amazon, reverse image lookup Amazon, Amazon search by photo, or competitor image search. Even if the user does not explicitly mention \"image search,\" this skill should be triggered whenever a user provides an image URL and wants to find visually matching or similar products on Amazon.",
        "operationId": "runAmazonSearchByImage",
        "externalDocs": {
          "description": "Amazon Search By Image documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-search-by-image"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-search-by-image.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Valid, publicly accessible image URL (maximum 1,000 characters)",
                    "example": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
                  },
                  "amazonDomain": {
                    "type": "string",
                    "description": "Amazon marketplace. Supported domains: United States (amazon.com), United Kingdom (amazon.co.uk), Germany (amazon.de), France (amazon.fr), Italy (amazon.it), Spain (amazon.es), Japan (amazon.co.jp), and India (amazon.in). Default: amazon.com",
                    "example": "amazon.com"
                  },
                  "sort": {
                    "type": "string",
                    "description": "Sort by price, rating, or rating count. Values: default, price-asc-rank, price-desc-rank, rating-asc-rank, rating-desc-rank, ratings-asc-rank, and ratings-desc-rank"
                  },
                  "deliveryZip": {
                    "type": "string",
                    "description": "Delivery postal code or city within the selected marketplace. If omitted, the marketplace default is used. Maximum 1,000 characters. Defaults: United States=10001, United Kingdom=EC1A 1BB, Germany=10115, France=75001, Italy=00100, Spain=28001, Japan=100-0001, and India=110034"
                  },
                  "countryOrAreaCode": {
                    "type": "string",
                    "description": "Destination country or region code for cross-border delivery, such as CN, JP, KR, TW, HK, MO, SG, TH, VN, PH, or MY. Do not provide this together with deliveryZip. Amazon India does not support cross-border destination settings. Maximum 1,000 characters"
                  },
                  "aggregateByKeepaData": {
                    "type": "boolean",
                    "description": "Whether to enrich results with Nexscope data such as sales rank, monthly sales, FBA fees, and dimensions",
                    "example": false
                  }
                },
                "required": [
                  "imageUrl",
                  "amazonDomain"
                ],
                "example": {
                  "aggregateByKeepaData": false,
                  "amazonDomain": "amazon.com",
                  "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
                },
                "additionalProperties": true
              },
              "example": {
                "aggregateByKeepaData": false,
                "amazonDomain": "amazon.com",
                "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total rows",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "perPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Items per page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "currentPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendering style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions used for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list; see the product fields below",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "asin": {
                                        "type": "string",
                                        "description": "ASIN",
                                        "example": "B072MQ5BRX"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "asinUrl": {
                                        "type": "string",
                                        "description": "Amazon ASIN detail URL",
                                        "example": "https://www.amazon.com/dp/B072MQ5BRX"
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current price in the marketplace currency",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "List price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Current rating from 0.0 to 5.0",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Rating count",
                                        "example": 1
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Product source type",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      },
                                      "salesRank": {
                                        "type": "integer",
                                        "description": "Sales rank from Nexscope",
                                        "example": 1
                                      },
                                      "salesRank30": {
                                        "type": "integer",
                                        "description": "Average sales rank over the past 30 days from Nexscope",
                                        "example": 1
                                      },
                                      "salesRank90": {
                                        "type": "integer",
                                        "description": "Average sales rank over the past 90 days from Nexscope",
                                        "example": 1
                                      },
                                      "salesRank180": {
                                        "type": "integer",
                                        "description": "Average sales rank over the past 180 days from Nexscope",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Monthly units sold from Nexscope",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Monthly sales revenue from Nexscope",
                                        "example": 1
                                      },
                                      "monthlySalesUnits1MonthAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 1 month ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits2MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 2 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits3MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 3 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits4MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 4 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits5MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 5 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits6MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 6 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits7MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 7 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits8MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 8 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits9MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 9 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits10MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 10 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits11MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 11 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "monthlySalesUnits12MonthsAgo": {
                                        "type": "integer",
                                        "description": "Monthly units sold 12 months ago, from Nexscope",
                                        "example": null
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Review count from Nexscope",
                                        "example": 1
                                      },
                                      "fbaFees": {
                                        "type": "number",
                                        "description": "FBA fulfillment fee in the marketplace currency from Nexscope",
                                        "example": 1
                                      },
                                      "profit": {
                                        "type": "number",
                                        "description": "Profit margin percentage from Nexscope; for example, 25.5 means 25.5%",
                                        "example": 1
                                      },
                                      "referralFeePercentage": {
                                        "type": "number",
                                        "description": "Referral fee percentage from Nexscope",
                                        "example": 1
                                      },
                                      "fulfillment": {
                                        "type": "string",
                                        "description": "Fulfillment method from Nexscope: AMZ, FBA, or FBM",
                                        "example": null
                                      },
                                      "primePrice": {
                                        "type": "number",
                                        "description": "Prime price from Nexscope",
                                        "example": 1
                                      },
                                      "buyBoxSellerId": {
                                        "type": "string",
                                        "description": "Buy Box seller ID from Nexscope",
                                        "example": "example-id"
                                      },
                                      "sellerNum": {
                                        "type": "integer",
                                        "description": "Seller count from Nexscope",
                                        "example": 1
                                      },
                                      "variationNum": {
                                        "type": "integer",
                                        "description": "Variation count from Nexscope",
                                        "example": 1
                                      },
                                      "parentAsin": {
                                        "type": "string",
                                        "description": "Parent ASIN from Nexscope",
                                        "example": "B072MQ5BRX"
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing date from Nexscope in yyyy-MM-dd HH:mm:ss format",
                                        "example": "2026-01-01"
                                      },
                                      "lastUpdate": {
                                        "type": "string",
                                        "description": "Last update time from Nexscope in yyyy-MM-dd HH:mm:ss format",
                                        "example": "2026-01-01"
                                      },
                                      "manufacturer": {
                                        "type": "string",
                                        "description": "Manufacturer from Nexscope",
                                        "example": null
                                      },
                                      "model": {
                                        "type": "string",
                                        "description": "Model from Nexscope",
                                        "example": null
                                      },
                                      "color": {
                                        "type": "string",
                                        "description": "Color from Nexscope",
                                        "example": null
                                      },
                                      "material": {
                                        "type": "string",
                                        "description": "Primary materials used in the product construction, from Nexscope",
                                        "example": null
                                      },
                                      "weight": {
                                        "type": "string",
                                        "description": "Weight in grams from Nexscope",
                                        "example": null
                                      },
                                      "dimension": {
                                        "type": "string",
                                        "description": "Dimensions from Nexscope",
                                        "example": null
                                      },
                                      "itemLength": {
                                        "type": "integer",
                                        "description": "Product length in millimeters from Nexscope; 0 or -1 when unavailable",
                                        "example": 1
                                      },
                                      "itemWidth": {
                                        "type": "integer",
                                        "description": "Product width in millimeters from Nexscope; 0 or -1 when unavailable",
                                        "example": 1
                                      },
                                      "itemHeight": {
                                        "type": "integer",
                                        "description": "Product height in millimeters from Nexscope; 0 or -1 when unavailable",
                                        "example": 1
                                      },
                                      "packageLength": {
                                        "type": "integer",
                                        "description": "Package length in millimeters from Nexscope",
                                        "example": 1
                                      },
                                      "packageWidth": {
                                        "type": "integer",
                                        "description": "Package width in millimeters from Nexscope",
                                        "example": 1
                                      },
                                      "packageHeight": {
                                        "type": "integer",
                                        "description": "Package height in millimeters from Nexscope",
                                        "example": 1
                                      },
                                      "packageWeight": {
                                        "type": "string",
                                        "description": "Package weight in grams from Nexscope",
                                        "example": null
                                      },
                                      "packageDimensions": {
                                        "type": "string",
                                        "description": "Package dimensions from Nexscope",
                                        "example": null
                                      },
                                      "packageQuantity": {
                                        "type": "integer",
                                        "description": "Number of items in the package from Nexscope; 0 or -1 when unavailable",
                                        "example": 1
                                      },
                                      "dimensionsType": {
                                        "type": "string",
                                        "description": "Dimension type from Nexscope",
                                        "example": null
                                      },
                                      "categoryTree": {
                                        "type": "string",
                                        "description": "Category tree from Nexscope",
                                        "example": null
                                      },
                                      "categoryTreeId": {
                                        "type": "string",
                                        "description": "Category tree ID from Nexscope",
                                        "example": "example-id"
                                      },
                                      "rootCategory": {
                                        "type": "integer",
                                        "description": "Root category ID from Nexscope",
                                        "example": 1
                                      },
                                      "isAdultProduct": {
                                        "type": "boolean",
                                        "description": "Whether the product is classified as adult content by Nexscope",
                                        "example": false
                                      },
                                      "isHazmat": {
                                        "type": "boolean",
                                        "description": "Whether the product is classified as hazardous by Nexscope",
                                        "example": false
                                      },
                                      "urlSlug": {
                                        "type": "string",
                                        "description": "URL slug from Nexscope",
                                        "example": null
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Product image URLs from Nexscope",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "totalCount": 1,
                    "perPage": 1,
                    "currentPage": 1,
                    "columns": [],
                    "costToken": 1,
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "imageUrl": "https://example.com/image.jpg",
                        "asinUrl": "https://www.amazon.com/dp/B072MQ5BRX",
                        "price": 1,
                        "oldPrice": 1,
                        "rating": 1,
                        "ratings": 1,
                        "salesRank": 1,
                        "salesRank30": 1,
                        "salesRank90": 1,
                        "salesRank180": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "reviewCount": 1,
                        "fbaFees": 1,
                        "profit": 1,
                        "referralFeePercentage": 1,
                        "primePrice": 1,
                        "buyBoxSellerId": "example-id",
                        "sellerNum": 1,
                        "variationNum": 1,
                        "parentAsin": "B072MQ5BRX",
                        "availableDate": "2026-01-01",
                        "lastUpdate": "2026-01-01",
                        "itemLength": 1,
                        "itemWidth": 1,
                        "itemHeight": 1,
                        "packageLength": 1,
                        "packageWidth": 1,
                        "packageHeight": 1,
                        "packageQuantity": 1,
                        "categoryTreeId": "example-id",
                        "rootCategory": 1,
                        "isAdultProduct": false,
                        "isHazmat": false,
                        "productImageUrls": []
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-search-by-image",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_search_by_image",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-traffic-keywords/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Amazon Traffic Keywords",
        "description": "Query traffic keyword lists for an Amazon ASIN via Nexscope, including traffic source type, conversion type, organic rank, and ad rank with historical month and multi-dimensional sorting. Trigger when user mentions ASIN reverse traffic keywords, traffic keyword list, keyword traffic structure, organic/ad keyword analysis, keyword conversion type, Nexscope traffic keyword, Amazon traffic keywords, reverse ASIN keywords — even if \"Nexscope\" is not explicitly mentioned, as long as the need involves viewing keyword traffic sources and keyword lists for a specific ASIN.",
        "operationId": "runAmazonTrafficKeywords",
        "externalDocs": {
          "description": "Amazon Traffic Keywords documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-traffic-keywords"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-traffic-keywords.",
                "properties": {
                  "marketplace": {
                    "type": "string",
                    "description": "Marketplace site, default US",
                    "example": "US"
                  },
                  "asin": {
                    "type": "string",
                    "description": "Product ASIN to reverse lookup",
                    "example": "B072MQ5BRX"
                  },
                  "month": {
                    "type": "string",
                    "description": "20)\\d{2}(0[1-9]"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Current page",
                    "example": 1
                  },
                  "size": {
                    "type": "integer",
                    "description": "Items per page",
                    "example": 1
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Keyword filter",
                    "example": "phone case"
                  },
                  "badges": {
                    "type": "string",
                    "description": "Traffic keyword type (impression position), see [Badges Enum](#badges-enum)"
                  },
                  "trafficKeywordTypes": {
                    "type": "string",
                    "description": "Traffic share type, see [trafficKeywordTypes Enum](#traffickeywordtypes-enum)"
                  },
                  "conversionKeywordTypes": {
                    "type": "string",
                    "description": "Traffic conversion type, see [conversionKeywordTypes Enum](#conversionkeywordtypes-enum)",
                    "example": "phone case"
                  },
                  "orderField": {
                    "type": "string",
                    "description": "Sort field, see [orderField Options](#orderfield-options)"
                  },
                  "orderDesc": {
                    "type": "boolean",
                    "description": "Whether to sort in descending order",
                    "example": false
                  }
                },
                "required": [
                  "marketplace",
                  "asin"
                ],
                "example": {
                  "asin": "B072MQ5BRX",
                  "marketplace": "US",
                  "size": 10,
                  "page": 1
                },
                "additionalProperties": true
              },
              "example": {
                "asin": "B072MQ5BRX",
                "marketplace": "US",
                "size": 10,
                "page": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "marketplace": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Marketplace code",
                                  "example": "US"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "asin": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Queried ASIN",
                                  "example": "B072MQ5BRX"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Traffic keyword list (corresponds to third-party data.items)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "keyword": {
                                        "type": "string",
                                        "description": "Keyword",
                                        "example": "phone case"
                                      },
                                      "keywordCn": {
                                        "type": "string",
                                        "description": "Keyword Chinese translation",
                                        "example": "phone case"
                                      },
                                      "trafficKeywordType": {
                                        "type": "string",
                                        "description": "Traffic share type",
                                        "example": "phone case"
                                      },
                                      "conversionKeywordType": {
                                        "type": "string",
                                        "description": "Traffic conversion type",
                                        "example": "phone case"
                                      },
                                      "badges": {
                                        "type": "array",
                                        "description": "Impression position (traffic keyword type)",
                                        "example": []
                                      },
                                      "rankPosition": {
                                        "type": "object",
                                        "description": "Organic ranking position info, see [Ranking Object](#ranking-object-rankposition--adposition)",
                                        "example": {},
                                        "properties": {
                                          "updatedTime": {
                                            "type": "integer",
                                            "description": "Ranking time",
                                            "example": 1
                                          },
                                          "pageSize": {
                                            "type": "integer",
                                            "description": "Items per page",
                                            "example": 1
                                          },
                                          "index": {
                                            "type": "integer",
                                            "description": "Position on current page",
                                            "example": 1
                                          },
                                          "page": {
                                            "type": "integer",
                                            "description": "Page number",
                                            "example": 1
                                          },
                                          "position": {
                                            "type": "integer",
                                            "description": "Position in total results",
                                            "example": 1
                                          }
                                        }
                                      },
                                      "adPosition": {
                                        "type": "object",
                                        "description": "Ad ranking position info, same structure as [Ranking Object](#ranking-object-rankposition--adposition)",
                                        "example": {},
                                        "properties": {
                                          "updatedTime": {
                                            "type": "integer",
                                            "description": "Ranking time",
                                            "example": 1
                                          },
                                          "pageSize": {
                                            "type": "integer",
                                            "description": "Items per page",
                                            "example": 1
                                          },
                                          "index": {
                                            "type": "integer",
                                            "description": "Position on current page",
                                            "example": 1
                                          },
                                          "page": {
                                            "type": "integer",
                                            "description": "Page number",
                                            "example": 1
                                          },
                                          "position": {
                                            "type": "integer",
                                            "description": "Position in total results",
                                            "example": 1
                                          }
                                        }
                                      },
                                      "searches": {
                                        "type": "integer",
                                        "description": "Monthly search volume",
                                        "example": 1
                                      },
                                      "searchesRank": {
                                        "type": "integer",
                                        "description": "Weekly search volume ranking",
                                        "example": 1
                                      },
                                      "searchesRankTimeFrom": {
                                        "type": "integer",
                                        "description": "Weekly search volume ranking time range start",
                                        "example": 1
                                      },
                                      "searchesRankTimeTo": {
                                        "type": "integer",
                                        "description": "Weekly search volume ranking time range end",
                                        "example": 1
                                      },
                                      "purchases": {
                                        "type": "integer",
                                        "description": "Monthly purchase volume",
                                        "example": 1
                                      },
                                      "purchaseRate": {
                                        "type": "number",
                                        "description": "Purchase rate",
                                        "example": 1
                                      },
                                      "products": {
                                        "type": "integer",
                                        "description": "Product count",
                                        "example": 1
                                      },
                                      "supplyDemandRatio": {
                                        "type": "number",
                                        "description": "Supply-demand ratio",
                                        "example": 1
                                      },
                                      "trafficPercentage": {
                                        "type": "number",
                                        "description": "Traffic share",
                                        "example": 1
                                      },
                                      "naturalRatio": {
                                        "type": "number",
                                        "description": "Traffic distribution - organic share",
                                        "example": 1
                                      },
                                      "adRatio": {
                                        "type": "number",
                                        "description": "Traffic distribution - ad share",
                                        "example": 1
                                      },
                                      "calculatedWeeklySearches": {
                                        "type": "number",
                                        "description": "Estimated weekly impressions",
                                        "example": 1
                                      },
                                      "impressions": {
                                        "type": "integer",
                                        "description": "Impressions",
                                        "example": 1
                                      },
                                      "clicks": {
                                        "type": "integer",
                                        "description": "Clicks",
                                        "example": 1
                                      },
                                      "bid": {
                                        "type": "number",
                                        "description": "PPC bid",
                                        "example": 1
                                      },
                                      "bidMin": {
                                        "type": "number",
                                        "description": "PPC bid lower limit",
                                        "example": 1
                                      },
                                      "bidMax": {
                                        "type": "number",
                                        "description": "PPC bid upper limit",
                                        "example": 1
                                      },
                                      "latest1daysAds": {
                                        "type": "integer",
                                        "description": "Ad competitors in the last 1 day",
                                        "example": 1
                                      },
                                      "latest7daysAds": {
                                        "type": "integer",
                                        "description": "Ad competitors in the last 7 days",
                                        "example": 1
                                      },
                                      "latest30daysAds": {
                                        "type": "integer",
                                        "description": "Ad competitors in the last 30 days",
                                        "example": 1
                                      },
                                      "sprt": {
                                        "type": "number",
                                        "description": "SP-related ratio",
                                        "example": 1
                                      },
                                      "monopolyClickRate": {
                                        "type": "number",
                                        "description": "Monopoly click rate",
                                        "example": 1
                                      },
                                      "top3ClickingRate": {
                                        "type": "number",
                                        "description": "Top 3 click rate",
                                        "example": 1
                                      },
                                      "top3ConversionRate": {
                                        "type": "number",
                                        "description": "Top 3 conversion rate",
                                        "example": 1
                                      },
                                      "titleDensity": {
                                        "type": "number",
                                        "description": "Title density",
                                        "example": 1
                                      },
                                      "stats": {
                                        "type": "array",
                                        "description": "High-frequency words, elements see table below",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "keywords": {
                                              "type": "string",
                                              "description": "Word",
                                              "example": "phone case"
                                            },
                                            "total": {
                                              "type": "integer",
                                              "description": "Total count",
                                              "example": 1
                                            },
                                            "rankPosition": {
                                              "type": "object",
                                              "description": "Organic ranking position",
                                              "example": {},
                                              "properties": {
                                                "updatedTime": {
                                                  "type": "integer",
                                                  "description": "Ranking time",
                                                  "example": 1
                                                },
                                                "pageSize": {
                                                  "type": "integer",
                                                  "description": "Items per page",
                                                  "example": 1
                                                },
                                                "index": {
                                                  "type": "integer",
                                                  "description": "Position on current page",
                                                  "example": 1
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "description": "Page number",
                                                  "example": 1
                                                },
                                                "position": {
                                                  "type": "integer",
                                                  "description": "Position in total results",
                                                  "example": 1
                                                }
                                              }
                                            },
                                            "adPosition": {
                                              "type": "object",
                                              "description": "Ad ranking position",
                                              "example": {},
                                              "properties": {
                                                "updatedTime": {
                                                  "type": "integer",
                                                  "description": "Ranking time",
                                                  "example": 1
                                                },
                                                "pageSize": {
                                                  "type": "integer",
                                                  "description": "Items per page",
                                                  "example": 1
                                                },
                                                "index": {
                                                  "type": "integer",
                                                  "description": "Position on current page",
                                                  "example": 1
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "description": "Page number",
                                                  "example": 1
                                                },
                                                "position": {
                                                  "type": "integer",
                                                  "description": "Position in total results",
                                                  "example": 1
                                                }
                                              }
                                            }
                                          }
                                        }
                                      },
                                      "updatedTime": {
                                        "type": "integer",
                                        "description": "Update time",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "summaryList": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "High-frequency keyword summary list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "total": {
                                        "type": "integer",
                                        "description": "Total count",
                                        "example": 1
                                      },
                                      "keywords": {
                                        "type": "string",
                                        "description": "Keywords",
                                        "example": "phone case"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "marketplace": "US",
                    "asin": "B072MQ5BRX",
                    "data": [
                      {
                        "keyword": "phone case",
                        "keywordCn": "phone case",
                        "trafficKeywordType": "phone case",
                        "conversionKeywordType": "phone case",
                        "badges": [],
                        "rankPosition": {
                          "updatedTime": 1,
                          "pageSize": 1,
                          "index": 1,
                          "page": 1,
                          "position": 1
                        },
                        "adPosition": {
                          "updatedTime": 1,
                          "pageSize": 1,
                          "index": 1,
                          "page": 1,
                          "position": 1
                        },
                        "searches": 1,
                        "searchesRank": 1,
                        "searchesRankTimeFrom": 1,
                        "searchesRankTimeTo": 1,
                        "purchases": 1,
                        "purchaseRate": 1,
                        "products": 1,
                        "supplyDemandRatio": 1,
                        "trafficPercentage": 1,
                        "naturalRatio": 1,
                        "adRatio": 1,
                        "calculatedWeeklySearches": 1,
                        "impressions": 1,
                        "clicks": 1,
                        "bid": 1,
                        "bidMin": 1,
                        "bidMax": 1,
                        "latest1daysAds": 1,
                        "latest7daysAds": 1,
                        "latest30daysAds": 1,
                        "sprt": 1,
                        "monopolyClickRate": 1,
                        "top3ClickingRate": 1,
                        "top3ConversionRate": 1,
                        "titleDensity": 1,
                        "stats": [
                          {
                            "keywords": "phone case",
                            "total": 1,
                            "rankPosition": {
                              "updatedTime": 1,
                              "pageSize": 1,
                              "index": 1,
                              "page": 1,
                              "position": 1
                            },
                            "adPosition": {
                              "updatedTime": 1,
                              "pageSize": 1,
                              "index": 1,
                              "page": 1,
                              "position": 1
                            }
                          }
                        ],
                        "updatedTime": 1
                      }
                    ],
                    "summaryList": [
                      {
                        "total": 1,
                        "keywords": "phone case"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-traffic-keywords",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_traffic_keywords",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ebay-search/run": {
      "post": {
        "tags": [
          "eBay Marketplace"
        ],
        "summary": "Ebay Search",
        "description": "Search and browse product listings across multiple eBay international sites. Trigger when user mentions eBay product search, eBay listing query, eBay price comparison, eBay market browsing, eBay sold items, eBay auction search, eBay product research, eBay products, eBay pricing, eBay competitors, eBay auctions, eBay market analysis — even if \"eBay\" is not explicitly mentioned, as long as the need involves searching products on eBay, comparing eBay prices, finding sold listings, or analyzing eBay market data.",
        "operationId": "runEbaySearch",
        "externalDocs": {
          "description": "Ebay Search documentation",
          "url": "https://www.nexscope.ai/api-docs/ebay-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ebay-search.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Search keyword, max 1024 characters",
                    "example": "phone case"
                  },
                  "ebayDomain": {
                    "type": "string",
                    "description": "eBay site domain, default ebay.com. Options: ebay.com (United States), ebay.co.uk (United Kingdom), ebay.de (Germany), ebay.fr (France), ebay.it (Italy), ebay.es (Spain), ebay.ca (Canada), ebay.com.au (Australia), ebay.nl (Netherlands), ebay.at (Austria), ebay.ch (Switzerland), ebay.pl (Poland), ebay.ie (Ireland), ebay.com.hk (Hong Kong, China), ebay.com.my (Malaysia), ebay.com.sg (Singapore)"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number for pagination, default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Maximum results per page, default 50. Options: 25, 50, 100, 200",
                    "example": 10
                  },
                  "orderBy": {
                    "type": "string",
                    "description": "Sort order, default 12 (Best Match). Options: 1 (Ending soonest), 2 (Price lowest), 3 (Price highest), 7 (Distance nearest), 10 (Newly listed), 12 (Best Match), 15 (Price + shipping lowest), 16 (Price + shipping highest), 18 (New first), 19 (Used first)"
                  },
                  "priceMin": {
                    "type": "number",
                    "description": "Minimum price filter",
                    "example": 1
                  },
                  "priceMax": {
                    "type": "number",
                    "description": "Maximum price filter",
                    "example": 1
                  },
                  "itemCondition": {
                    "type": "string",
                    "description": "Item condition code, multiple separated by \\"
                  },
                  "buyingFormat": {
                    "type": "string",
                    "description": "Buying format. Options: Auction, BIN (Buy It Now), BO (Best Offer)"
                  },
                  "showOnly": {
                    "type": "string",
                    "description": "Filter conditions, comma-separated for multiple values. Options: Complete (Ended), Sold (Sold), FR (Free returns), RPA (Returns accepted), AS (Authorized seller), Savings (Discounts), SaleItems (Sale items), Lots (Lots), Charity (Charity), AV, FS (Free shipping), LPickup (Local pickup)"
                  },
                  "location": {
                    "type": "integer",
                    "description": "Country/region code of item location (e.g., 1=United States, 2=Canada, 3=United Kingdom, 45=China, 77=Germany)",
                    "example": 1
                  },
                  "prefLoc": {
                    "type": "string",
                    "description": "Preferred location scope. Options: 1 (Domestic), 2 (Regional), 3 (Worldwide)"
                  },
                  "zipCode": {
                    "type": "string",
                    "description": "ZIP or postal code for filtering shippable items by region"
                  },
                  "categoryId": {
                    "type": "integer",
                    "description": "eBay category ID for category-specific search",
                    "example": 1
                  },
                  "noCache": {
                    "type": "boolean",
                    "description": "Whether to bypass cache, default false",
                    "example": false
                  }
                },
                "example": {
                  "page": 1,
                  "keyword": "phone case",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "phone case",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total matching results",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list array (see product fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "string",
                                        "description": "eBay product ID",
                                        "example": "example-id"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "subtitle": {
                                        "type": "string",
                                        "description": "Product subtitle",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current price / transaction price",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Price range start value (for multi-SKU items)",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Price range end value (for multi-SKU items)",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "Original price before discount",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency unit (e.g., USD, GBP, EUR)",
                                        "example": null
                                      },
                                      "condition": {
                                        "type": "string",
                                        "description": "Item condition description",
                                        "example": null
                                      },
                                      "link": {
                                        "type": "string",
                                        "description": "eBay product detail page link",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product thumbnail URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "shipping": {
                                        "type": "string",
                                        "description": "Shipping information",
                                        "example": null
                                      },
                                      "location": {
                                        "type": "string",
                                        "description": "Item location",
                                        "example": null
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerReviews": {
                                        "type": "integer",
                                        "description": "Seller feedback count",
                                        "example": 1
                                      },
                                      "positiveFeedbackInPercentage": {
                                        "type": "number",
                                        "description": "Seller positive feedback percentage",
                                        "example": 1
                                      },
                                      "salesQuantity": {
                                        "type": "integer",
                                        "description": "Quantity sold",
                                        "example": 1
                                      },
                                      "bidsCount": {
                                        "type": "integer",
                                        "description": "Bid count (for auction items)",
                                        "example": 1
                                      },
                                      "returns": {
                                        "type": "string",
                                        "description": "Return information",
                                        "example": null
                                      },
                                      "promotion": {
                                        "type": "string",
                                        "description": "Promotion information",
                                        "example": null
                                      },
                                      "sponsored": {
                                        "type": "boolean",
                                        "description": "Whether sponsored/promoted item",
                                        "example": false
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source platform identifier (ebay)",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style identifier",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": "example-id",
                        "price": 1,
                        "minPrice": 1,
                        "maxPrice": 1,
                        "oldPrice": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "sellerReviews": 1,
                        "positiveFeedbackInPercentage": 1,
                        "salesQuantity": 1,
                        "bidsCount": 1,
                        "sponsored": false
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ebay-search",
        "x-nexscope-mcp-tool-name": "nexscope_ebay_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/etsy-category-search/run": {
      "post": {
        "tags": [
          "Etsy Marketplace"
        ],
        "summary": "Etsy Category Search",
        "description": "Search Etsy category data by name, ID, or parent IDs to find category identifiers for product/store filtering. Trigger when user mentions Etsy category, Etsy category ID, Etsy category tree, Etsy category lookup, syncEtsyCategory, or category search — even if the tool name is not mentioned, as long as the need is to find a category ID by keyword in a locally synced Etsy category library.",
        "operationId": "runEtsyCategorySearch",
        "externalDocs": {
          "description": "Etsy Category Search documentation",
          "url": "https://www.nexscope.ai/api-docs/etsy-category-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.etsy-category-search.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Keyword: matches category name, category id, or parentIds fields (substring)",
                    "example": "phone case"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, max 200",
                    "example": 1
                  }
                },
                "required": [
                  "keyword"
                ],
                "example": {
                  "page": 1,
                  "keyword": "phone case",
                  "pageSize": 1
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "phone case",
                "pageSize": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records returned on this page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption (local retrieval is free)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "categories": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "List of matching categories",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "categoryLevel": {
                                        "type": "integer",
                                        "description": "Category level",
                                        "example": 1
                                      },
                                      "id": {
                                        "type": "string",
                                        "description": "Category ID",
                                        "example": "example-id"
                                      },
                                      "name": {
                                        "type": "string",
                                        "description": "Category name",
                                        "example": null
                                      },
                                      "parentId": {
                                        "type": "string",
                                        "description": "Canonical primary parent category ID",
                                        "example": "example-id"
                                      },
                                      "parentIds": {
                                        "type": "string",
                                        "description": "All non-empty parent category IDs (comma-separated)",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "costToken": 1,
                    "categories": [
                      {
                        "categoryLevel": 1,
                        "id": "example-id",
                        "parentId": "example-id"
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "etsy-category-search",
        "x-nexscope-mcp-tool-name": "nexscope_etsy_category_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/etsy-product-query/run": {
      "post": {
        "tags": [
          "Etsy Marketplace"
        ],
        "summary": "Etsy Product Query",
        "description": "Query Etsy products with multi-dimensional filters (keyword/URL, price, sales, favorites, reviews, listing date, category, handmade/vintage types, Pick/Bestseller/Raving tags). Trigger when user mentions Etsy products, Etsy listings, Etsy product sourcing, Etsy bestsellers, Etsy handmade, Etsy vintage, Etsy items, or Etsy product query — even if the tool name is not mentioned, as long as the need is to search products, view sales/price/tags, or filter items on Etsy.",
        "operationId": "runEtsyProductQuery",
        "externalDocs": {
          "description": "Etsy Product Query documentation",
          "url": "https://www.nexscope.ai/api-docs/etsy-product-query"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.etsy-product-query.",
                "properties": {
                  "beginFavorites": {
                    "type": "integer",
                    "description": "Favorite count (start), combined with end value to form the upstream favorites range",
                    "example": 1
                  },
                  "beginFavoritesWeekly": {
                    "type": "integer",
                    "description": "Weekly new favorites (start), combined with end value to form the upstream favorites_weekly range",
                    "example": 1
                  },
                  "beginPrice": {
                    "type": "number",
                    "description": "Price (start), combined with end price to form the upstream price range (e.g., 20~100). When only one side is provided, the upstream returns start~ or ~end",
                    "example": 1
                  },
                  "beginReviews": {
                    "type": "integer",
                    "description": "Review count (start), combined with end value to form the upstream reviews range",
                    "example": 1
                  },
                  "beginReviewsWeekly": {
                    "type": "integer",
                    "description": "Weekly new reviews (start), combined with end value to form the upstream reviews_weekly range",
                    "example": 1
                  },
                  "beginSales": {
                    "type": "integer",
                    "description": "Total sales (start), combined with end value to form the upstream sales range",
                    "example": 1
                  },
                  "beginSalesWeekly": {
                    "type": "integer",
                    "description": "Weekly sales (start), combined with end value to form the upstream sales_weekly range (e.g., 1~100)",
                    "example": 1
                  },
                  "category": {
                    "type": "string",
                    "description": "Product category ID (single category), see the Category Query API"
                  },
                  "country": {
                    "type": "string",
                    "description": "Shipping country"
                  },
                  "currencyCode": {
                    "type": "string",
                    "description": "Currency code"
                  },
                  "endFavorites": {
                    "type": "integer",
                    "description": "Favorite count (end)",
                    "example": 1
                  },
                  "endFavoritesWeekly": {
                    "type": "integer",
                    "description": "Weekly new favorites (end)",
                    "example": 1
                  },
                  "endPrice": {
                    "type": "number",
                    "description": "Price (end), combined with start price to form the upstream price range",
                    "example": 1
                  },
                  "endReviews": {
                    "type": "integer",
                    "description": "Review count (end)",
                    "example": 1
                  },
                  "endReviewsWeekly": {
                    "type": "integer",
                    "description": "Weekly new reviews (end)",
                    "example": 1
                  },
                  "endSales": {
                    "type": "integer",
                    "description": "Total sales (end)",
                    "example": 1
                  },
                  "endSalesWeekly": {
                    "type": "integer",
                    "description": "Weekly sales (end)",
                    "example": 1
                  },
                  "isBestsell": {
                    "type": "integer",
                    "description": "Whether the product is a bestseller",
                    "example": 1
                  },
                  "isPick": {
                    "type": "integer",
                    "description": "Whether the product is a Pick item",
                    "example": 1
                  },
                  "isRaving": {
                    "type": "integer",
                    "description": "Whether the product is a Raving item",
                    "example": 1
                  },
                  "listedTime": {
                    "type": "string",
                    "description": "Listing time no earlier than this date (YYYY-MM-DD)"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, max 100, recommended not to exceed 50",
                    "example": 10
                  },
                  "productType": {
                    "type": "string",
                    "description": "Product type, comma-separated for multiple: 1=Handmade 2=Vintage 3=Digital 4=Custom 9=Other"
                  },
                  "searchKey": {
                    "type": "string",
                    "description": "Search keyword or Etsy product URL"
                  },
                  "sortBy": {
                    "type": "integer",
                    "description": "Sort field (corresponds to upstream sort_by, values 1~6)",
                    "example": 1
                  },
                  "sortDesc": {
                    "type": "integer",
                    "description": "Sort direction (corresponds to upstream desc). Schema example: descending 1, ascending 2 (encoding differs from store query's sortDesc)",
                    "example": 1
                  },
                  "status": {
                    "type": "integer",
                    "description": "Product status (example: 1=active, 0=inactive)",
                    "example": 1
                  }
                },
                "example": {
                  "page": 1,
                  "pageSize": 10,
                  "searchKey": "phone case"
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "pageSize": 10,
                "searchKey": "phone case"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count (number of records returned on this page, for alignment with list length)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Tool type: ehunt",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: etsy",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption (estimated based on records returned on this page)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "productNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matching products (upstream product_num)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Etsy product list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "category": {
                                        "type": "string",
                                        "description": "Category name",
                                        "example": null
                                      },
                                      "favorites": {
                                        "type": "integer",
                                        "description": "Favorite count",
                                        "example": 1
                                      },
                                      "favoritesWeekly": {
                                        "type": "integer",
                                        "description": "Weekly new favorites",
                                        "example": 1
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "isBestsell": {
                                        "type": "integer",
                                        "description": "Whether bestseller: 1=Yes",
                                        "example": 1
                                      },
                                      "isPick": {
                                        "type": "integer",
                                        "description": "Whether Pick: 1=Yes",
                                        "example": 1
                                      },
                                      "isRaving": {
                                        "type": "integer",
                                        "description": "Whether Raving: 1=Yes",
                                        "example": 1
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Price",
                                        "example": 1
                                      },
                                      "productUrl": {
                                        "type": "string",
                                        "description": "Product link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "releaseTime": {
                                        "type": "string",
                                        "description": "Listing/release time",
                                        "example": null
                                      },
                                      "reviews": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "reviewsWeekly": {
                                        "type": "integer",
                                        "description": "Weekly new reviews",
                                        "example": 1
                                      },
                                      "salesTotal": {
                                        "type": "integer",
                                        "description": "Total sales",
                                        "example": 1
                                      },
                                      "salesWeekly": {
                                        "type": "integer",
                                        "description": "Weekly sales",
                                        "example": 1
                                      },
                                      "shipsFrom": {
                                        "type": "string",
                                        "description": "Shipping country",
                                        "example": null
                                      },
                                      "status": {
                                        "type": "integer",
                                        "description": "Product status: 1=active, 0=inactive",
                                        "example": 1
                                      },
                                      "storeName": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "tags": {
                                        "type": "string",
                                        "description": "Tags",
                                        "example": null
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "columns": [],
                    "costToken": 1,
                    "productNum": 1,
                    "products": [
                      {
                        "favorites": 1,
                        "favoritesWeekly": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "isBestsell": 1,
                        "isPick": 1,
                        "isRaving": 1,
                        "price": 1,
                        "productUrl": "https://example.com/image.jpg",
                        "reviews": 1,
                        "reviewsWeekly": 1,
                        "salesTotal": 1,
                        "salesWeekly": 1,
                        "status": 1
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "etsy-product-query",
        "x-nexscope-mcp-tool-name": "nexscope_etsy_product_query",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/google-ai-mode-search/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "Google AI Mode Search",
        "description": "AI Overview (AI Mode) scraping via Google Search. Returns AI-summarized key points for a single keyword, ideal for deep research, technical Q&A, long-tail product selection, and cross-border consumer preference analysis using the latest web information. Single-round only; follow-ups require the agent to summarize context and issue a new request. Triggered by: Google AI, AI Overview, AI Mode, Google AI search, AI search, deep research, consumer preference analysis, web summary, long-tail product research, cross-border market insights.",
        "operationId": "runGoogleAiModeSearch",
        "externalDocs": {
          "description": "Google AI Mode Search documentation",
          "url": "https://www.nexscope.ai/api-docs/google-ai-mode-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.google-ai-mode-search.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Google search keyword, passed as the q= parameter to initiate a Google AI Mode search. Only supports single-turn conversation; follow-up prompts are not supported. To ask follow-up questions, the agent must independently summarize key information from the previous AI overview, concatenate the new question, and send it as a new keyword in a new request",
                    "example": "best phone case material for iPhone"
                  }
                },
                "required": [
                  "keyword"
                ],
                "example": {
                  "keyword": "best phone case material for iPhone"
                },
                "additionalProperties": true
              },
              "example": {
                "keyword": "best phone case material for iPhone"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "stdout": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "AI overview content in Markdown format; outputs key points and reference source links for each question's AI overview in order",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceUrl": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Target URL that was crawled, the final Google search page URL",
                                  "example": "https://example.com/image.jpg"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "resultsNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of AI overview blocks; >0 indicates the page rendered an AI Overview, 0 indicates the keyword did not trigger an AI Overview",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency in milliseconds",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption for this call; billed only when upstream returns success",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "taskId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Upstream capture task identifier for this request",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style, fixed stdoutWorkbenches, used with the stdout field for Markdown rendering",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "sourceUrl": "https://example.com/image.jpg",
                    "resultsNum": 1,
                    "costTime": 1,
                    "costToken": 1,
                    "taskId": "example-id"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "google-ai-mode-search",
        "x-nexscope-mcp-tool-name": "nexscope_google_ai_mode_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/google-trends-by-keywords/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Google Trends By Keywords",
        "description": "Google Trends keyword search popularity comparison and trend analysis, supporting global regions and custom time ranges. Triggered by: Google Trends, keyword popularity over time, search interest comparison, keyword trend analysis, seasonal trend detection, regional search popularity, keyword heatmap, multi-keyword comparison on Google, keyword research, market trend analysis, search trends, seasonal analysis, regional popularity.",
        "operationId": "runGoogleTrendsByKeywords",
        "externalDocs": {
          "description": "Google Trends By Keywords documentation",
          "url": "https://www.nexscope.ai/api-docs/google-trends-by-keywords"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.google-trends-by-keywords.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Keyword (the keyword must be in the language of the target country! For example, use English keywords for the US, German keywords for Germany. If not in the corresponding country's language, please translate first.) Max length 100 characters",
                    "example": "phone case"
                  },
                  "region": {
                    "type": "string",
                    "description": "Country/region, default US. Options: US, GB, JP, CA, MX, DE, FR, IT, ES, NL, AU, SG, AE, BR, IN, TR, PL, SE",
                    "example": "US"
                  },
                  "dayRangeStart": {
                    "type": "string",
                    "description": "Time range start (use when you want to freely specify the time range; custom time range takes priority), format YYYY-MM-DD, starting from 2004"
                  },
                  "dayRangeEnd": {
                    "type": "string",
                    "description": "Time range end (use when you want to freely specify the time range; custom time range takes priority), format YYYY-MM-DD, starting from 2004"
                  }
                },
                "required": [
                  "keyword"
                ],
                "example": {
                  "keyword": "phone case",
                  "region": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "keyword": "phone case",
                "region": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "trendInfoForKeys": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Keyword trend info array",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "keyword": {
                                        "type": "string",
                                        "description": "Keyword",
                                        "example": "phone case"
                                      },
                                      "trendValues": {
                                        "type": "array",
                                        "description": "Trend value array",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "timeRange": {
                                              "type": "string",
                                              "description": "Time, format yyyy-MM-dd",
                                              "example": null
                                            },
                                            "value": {
                                              "type": "string",
                                              "description": "Value (normalized search interest, 0-100)",
                                              "example": null
                                            }
                                          }
                                        }
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "chartOption": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "description": "Chart rendering metadata",
                                  "example": {},
                                  "properties": {
                                    "type": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "Data type",
                                          "example": null
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "fieldX": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "X-axis field",
                                          "example": null
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "fieldY": {
                                      "anyOf": [
                                        {
                                          "type": "array",
                                          "description": "Y-axis fields",
                                          "example": []
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "data": {
                                      "anyOf": [
                                        {
                                          "type": "array",
                                          "description": "Data",
                                          "example": []
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "trendInfoForKeys": [
                      {
                        "keyword": "phone case",
                        "trendValues": []
                      }
                    ],
                    "chartOption": {
                      "fieldY": [],
                      "data": []
                    },
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "google-trends-by-keywords",
        "x-nexscope-mcp-tool-name": "nexscope_google_trends_by_keywords",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/google-trends-by-time/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "Google Trends By Time",
        "description": "Query and analyze Google Trends real-time hot topics and trending searches for a specified time range and country/region. Triggered by: Google Trends, hot topics, real-time trending, popular trends, current hot searches, recent trending, viral topics, trending searches, trend discovery, market trends, what's popular, trending now, breakout topics.",
        "operationId": "runGoogleTrendsByTime",
        "externalDocs": {
          "description": "Google Trends By Time documentation",
          "url": "https://www.nexscope.ai/api-docs/google-trends-by-time"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.google-trends-by-time.",
                "properties": {
                  "days": {
                    "type": "integer",
                    "description": "Time range, query trend data for the last N days, default 7. Common values: 1, 2, 7",
                    "example": 1
                  },
                  "region": {
                    "type": "string",
                    "description": "Country/region code, default US. Options: US, GB, JP, CA, MX, DE, FR, IT, ES, NL, AU, SG, AE, BR, IN, TR, PL, SE",
                    "example": "US"
                  }
                },
                "example": {
                  "days": 1,
                  "region": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "days": 1,
                "region": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token consumption",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "chartOption": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "description": "Chart config object, containing visualization data",
                                  "example": {},
                                  "properties": {
                                    "data": {
                                      "anyOf": [
                                        {
                                          "type": "array",
                                          "description": "Data, array of chart data point objects",
                                          "example": []
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "fieldX": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "X-axis field",
                                          "example": null
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "fieldY": {
                                      "anyOf": [
                                        {
                                          "type": "array",
                                          "description": "Y-axis fields",
                                          "example": []
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "type": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "Data type",
                                          "example": null
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "title": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "Title",
                                          "example": null
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "trendValues": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Trend values, array of trending query objects (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "query": {
                                        "type": "string",
                                        "description": "Keyword",
                                        "example": "phone case"
                                      },
                                      "searchVolume": {
                                        "type": "integer",
                                        "description": "Search volume value",
                                        "example": 1
                                      },
                                      "increasePercentage": {
                                        "type": "integer",
                                        "description": "Percentage increase: integer, range -100 to 100, unit is %",
                                        "example": 1
                                      },
                                      "startTime": {
                                        "type": "string",
                                        "description": "Start timestamp",
                                        "example": null
                                      },
                                      "endTime": {
                                        "type": "string",
                                        "description": "End timestamp",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "costToken": 1,
                    "chartOption": {
                      "data": [],
                      "fieldY": []
                    },
                    "trendValues": [
                      {
                        "query": "phone case",
                        "searchVolume": 1,
                        "increasePercentage": 1
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "google-trends-by-time",
        "x-nexscope-mcp-tool-name": "nexscope_google_trends_by_time",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/banana-image-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "Nano Banana Image Generation",
        "description": "Generate ecommerce images with the Nano Banana base image model. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runBananaImageGeneration",
        "externalDocs": {
          "description": "Nano Banana Image Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/banana-image-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate ecommerce images with the Nano Banana base image model.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K only.",
                    "example": "1K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 4:5, 5:4, 21:9.",
                    "example": "1:1"
                  }
                },
                "required": [
                  "imageUrls",
                  "prompt"
                ],
                "example": {
                  "imageUrls": [
                    "https://example.com/product.jpg"
                  ],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [
                  "https://example.com/product.jpg"
                ],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "banana-image-generation",
        "x-nexscope-mcp-tool-name": "nexscope_banana_image_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/banana-pro-image-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "Nano Banana Pro Image Generation",
        "description": "Generate higher-resolution ecommerce images with the Nano Banana Pro model. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runBananaProImageGeneration",
        "externalDocs": {
          "description": "Nano Banana Pro Image Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/banana-pro-image-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate higher-resolution ecommerce images with the Nano Banana Pro model.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K, 2K, or 4K; defaults to 1K.",
                    "example": "1K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 4:5, 5:4, 21:9.",
                    "example": "1:1"
                  }
                },
                "required": [
                  "imageUrls",
                  "prompt"
                ],
                "example": {
                  "imageUrls": [
                    "https://example.com/product.jpg"
                  ],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [
                  "https://example.com/product.jpg"
                ],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "banana-pro-image-generation",
        "x-nexscope-mcp-tool-name": "nexscope_banana_pro_image_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/banana-2-1-image-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "Nano Banana 2.1 Image Generation",
        "description": "Generate and edit ecommerce images with Nano Banana 2.1, with improved text layout and consistency across editing rounds. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runBanana21ImageGeneration",
        "externalDocs": {
          "description": "Nano Banana 2.1 Image Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/banana-2-1-image-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate and edit ecommerce images with Nano Banana 2.1, with improved text layout and consistency across editing rounds.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "description": "Optional public reference image URLs. Omit this field for text-to-image generation, or provide references for image-to-image generation. When supplied, provide 1 to 14 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [],
                    "items": {
                      "type": "string"
                    },
                    "minItems": 0,
                    "maxItems": 14
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K, 2K, or 4K; defaults to 1K.",
                    "example": "1K",
                    "enum": [
                      "1K",
                      "2K",
                      "4K"
                    ]
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 4:5, 5:4, 21:9.",
                    "example": "1:1",
                    "enum": [
                      "1:1",
                      "16:9",
                      "9:16",
                      "3:4",
                      "4:3",
                      "3:2",
                      "2:3",
                      "4:5",
                      "5:4",
                      "21:9"
                    ]
                  }
                },
                "required": [
                  "prompt"
                ],
                "example": {
                  "imageUrls": [],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "banana-2-1-image-generation",
        "x-nexscope-mcp-tool-name": "nexscope_banana_2_1_image_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/banana-2-image-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "Nano Banana 2 Image Generation",
        "description": "Generate ecommerce images with the Nano Banana 2 model. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runBanana2ImageGeneration",
        "externalDocs": {
          "description": "Nano Banana 2 Image Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/banana-2-image-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate ecommerce images with the Nano Banana 2 model.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K, 2K, or 4K; defaults to 1K.",
                    "example": "1K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 16:9, 9:16, 21:9.",
                    "example": "1:1"
                  }
                },
                "required": [
                  "imageUrls",
                  "prompt"
                ],
                "example": {
                  "imageUrls": [
                    "https://example.com/product.jpg"
                  ],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [
                  "https://example.com/product.jpg"
                ],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "banana-2-image-generation",
        "x-nexscope-mcp-tool-name": "nexscope_banana_2_image_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/banana-2-lite-image-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "Nano Banana 2 Lite Image Generation",
        "description": "Generate ecommerce images with the Nano Banana 2 Lite model. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runBanana2LiteImageGeneration",
        "externalDocs": {
          "description": "Nano Banana 2 Lite Image Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/banana-2-lite-image-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate ecommerce images with the Nano Banana 2 Lite model.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K only.",
                    "example": "1K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.",
                    "example": "1:1"
                  }
                },
                "required": [
                  "imageUrls",
                  "prompt"
                ],
                "example": {
                  "imageUrls": [
                    "https://example.com/product.jpg"
                  ],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [
                  "https://example.com/product.jpg"
                ],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "banana-2-lite-image-generation",
        "x-nexscope-mcp-tool-name": "nexscope_banana_2_lite_image_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/wan-2-7-image-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "Wan 2.7 Image Generation",
        "description": "Generate ecommerce images with the Wan 2.7 image model. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runWan27ImageGeneration",
        "externalDocs": {
          "description": "Wan 2.7 Image Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/wan-2-7-image-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate ecommerce images with the Wan 2.7 image model.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K or 2K; defaults to 1K.",
                    "example": "1K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 1:4, 4:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 16:9, 9:16, 21:9.",
                    "example": "1:1"
                  }
                },
                "required": [
                  "imageUrls",
                  "prompt"
                ],
                "example": {
                  "imageUrls": [
                    "https://example.com/product.jpg"
                  ],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [
                  "https://example.com/product.jpg"
                ],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "wan-2-7-image-generation",
        "x-nexscope-mcp-tool-name": "nexscope_wan_2_7_image_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seedream-5-pro-image-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "Seedream 5 Pro Image Generation",
        "description": "Generate ecommerce images with the Seedream 5 Pro image model. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runSeedream5ProImageGeneration",
        "externalDocs": {
          "description": "Seedream 5 Pro Image Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/seedream-5-pro-image-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate ecommerce images with the Seedream 5 Pro image model.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K or 2K; defaults to 1K.",
                    "example": "1K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 3:4, 4:3, 9:16, 16:9, 3:2, 2:3, 21:9.",
                    "example": "1:1"
                  }
                },
                "required": [
                  "imageUrls",
                  "prompt"
                ],
                "example": {
                  "imageUrls": [
                    "https://example.com/product.jpg"
                  ],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [
                  "https://example.com/product.jpg"
                ],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seedream-5-pro-image-generation",
        "x-nexscope-mcp-tool-name": "nexscope_seedream_5_pro_image_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/gpt-image-2-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "GPT Image 2 Generation",
        "description": "Generate ecommerce images with the GPT Image 2 model and optional quality control. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runGptImage2Generation",
        "externalDocs": {
          "description": "GPT Image 2 Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/gpt-image-2-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate ecommerce images with the GPT Image 2 model and optional quality control.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K, 2K, or 4K; defaults to 1K.",
                    "example": "1K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21.",
                    "example": "1:1"
                  },
                  "quality": {
                    "type": "string",
                    "description": "GPT Image quality. Supported values: low, medium, or high; defaults to medium.",
                    "example": "medium"
                  }
                },
                "required": [
                  "imageUrls",
                  "prompt"
                ],
                "example": {
                  "imageUrls": [
                    "https://example.com/product.jpg"
                  ],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1",
                  "quality": "medium"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [
                  "https://example.com/product.jpg"
                ],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1",
                "quality": "medium"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "gpt-image-2-generation",
        "x-nexscope-mcp-tool-name": "nexscope_gpt_image_2_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seedance-2-0-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Seedance 2.0 Video Generation",
        "description": "Generate a video with Seedance 2.0 using a primary image, up to 9 reference images, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runSeedance20VideoGeneration",
        "externalDocs": {
          "description": "Seedance 2.0 Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/seedance-2-0-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a video with Seedance 2.0 using a primary image, up to 9 reference images, or a reference video.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.",
                    "example": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 480p, 720p, 1080p.",
                    "example": "720p"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of a first-frame or primary reference image. Each image must be between 300 and 6000 pixels in both width and height.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 9 images. Each image must be between 300 and 6000 pixels in both width and height.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 9
                  },
                  "video": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.",
                    "example": [
                      "https://example.com/reference-video.mp4"
                    ],
                    "minItems": 1
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive.",
                    "example": "16:9"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt"
                ],
                "example": {
                  "videoTime": 10,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageUrl": "https://example.com/source-image.jpg",
                  "resolution": "720p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 10,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageUrl": "https://example.com/source-image.jpg",
                "resolution": "720p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seedance-2-0-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_seedance_2_0_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seedance-2-0-fast-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Seedance 2.0 Fast Video Generation",
        "description": "Generate a faster Seedance 2.0 video using a primary image, up to 9 reference images, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runSeedance20FastVideoGeneration",
        "externalDocs": {
          "description": "Seedance 2.0 Fast Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/seedance-2-0-fast-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a faster Seedance 2.0 video using a primary image, up to 9 reference images, or a reference video.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.",
                    "example": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 480p, 720p.",
                    "example": "720p"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of a first-frame or primary reference image. Each image must be between 300 and 6000 pixels in both width and height.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 9 images. Each image must be between 300 and 6000 pixels in both width and height.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 9
                  },
                  "video": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.",
                    "example": [
                      "https://example.com/reference-video.mp4"
                    ],
                    "minItems": 1
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive.",
                    "example": "16:9"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt"
                ],
                "example": {
                  "videoTime": 10,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageUrl": "https://example.com/source-image.jpg",
                  "resolution": "720p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 10,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageUrl": "https://example.com/source-image.jpg",
                "resolution": "720p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seedance-2-0-fast-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_seedance_2_0_fast_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seedance-2-0-mini-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Seedance 2.0 Mini Video Generation",
        "description": "Generate a compact Seedance 2.0 video using a primary image, up to 9 reference images, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runSeedance20MiniVideoGeneration",
        "externalDocs": {
          "description": "Seedance 2.0 Mini Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/seedance-2-0-mini-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a compact Seedance 2.0 video using a primary image, up to 9 reference images, or a reference video.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.",
                    "example": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 480p, 720p.",
                    "example": "720p"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of a first-frame or primary reference image. Each image must be between 300 and 6000 pixels in both width and height.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 9 images. Each image must be between 300 and 6000 pixels in both width and height.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 9
                  },
                  "video": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.",
                    "example": [
                      "https://example.com/reference-video.mp4"
                    ],
                    "minItems": 1
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive.",
                    "example": "16:9"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt"
                ],
                "example": {
                  "videoTime": 10,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageUrl": "https://example.com/source-image.jpg",
                  "resolution": "720p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 10,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageUrl": "https://example.com/source-image.jpg",
                "resolution": "720p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seedance-2-0-mini-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_seedance_2_0_mini_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seedance-2-5-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Seedance 2.5 Video Generation",
        "description": "Generate a Seedance 2.5 video using a primary image, up to 30 reference images, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runSeedance25VideoGeneration",
        "externalDocs": {
          "description": "Seedance 2.5 Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/seedance-2-5-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a Seedance 2.5 video using a primary image, up to 30 reference images, or a reference video.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: any integer from 4 through 30.",
                    "example": 5
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 480p, 720p, 1080p.",
                    "example": "480p"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of a first-frame or primary reference image. Each image must be between 300 and 6000 pixels in both width and height.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 30 images. Each image must be between 300 and 6000 pixels in both width and height.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 30
                  },
                  "video": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.",
                    "example": [
                      "https://example.com/reference-video.mp4"
                    ],
                    "minItems": 1
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.",
                    "example": "16:9"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt"
                ],
                "example": {
                  "videoTime": 5,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageUrl": "https://example.com/source-image.jpg",
                  "resolution": "480p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 5,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageUrl": "https://example.com/source-image.jpg",
                "resolution": "480p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seedance-2-5-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_seedance_2_5_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/kling-2-6-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Kling 2.6 Video Generation",
        "description": "Generate a Kling 2.6 video using a first frame, first/last frames, or up to 2 reference images. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runKling26VideoGeneration",
        "externalDocs": {
          "description": "Kling 2.6 Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/kling-2-6-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a Kling 2.6 video using a first frame, first/last frames, or up to 2 reference images.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 5, 10.",
                    "example": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 720p, 1080p.",
                    "example": "1080p"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of a first-frame or primary reference image.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 2 images.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 2
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.",
                    "example": "16:9"
                  },
                  "lastFrameImageUrl": {
                    "type": "string",
                    "description": "Optional public URL of the final-frame image. Requires 1080p.",
                    "example": "https://example.com/last-frame.jpg"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt"
                ],
                "example": {
                  "videoTime": 10,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageUrl": "https://example.com/source-image.jpg",
                  "resolution": "1080p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 10,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageUrl": "https://example.com/source-image.jpg",
                "resolution": "1080p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "kling-2-6-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_kling_2_6_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/kling-3-omni-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Kling 3 Omni Video Generation",
        "description": "Generate a Kling 3 Omni video using first/last frames or up to 7 reference images. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runKling3OmniVideoGeneration",
        "externalDocs": {
          "description": "Kling 3 Omni Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/kling-3-omni-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a Kling 3 Omni video using first/last frames or up to 7 reference images.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 5, 10, 15.",
                    "example": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 720p, 1080p.",
                    "example": "1080p"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of a first-frame or primary reference image.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 7 images.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 7
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: 1:1, 9:16, 16:9.",
                    "example": "1:1"
                  },
                  "lastFrameImageUrl": {
                    "type": "string",
                    "description": "Optional public URL of the final-frame image. Requires 1080p and cannot be combined with voice=true.",
                    "example": "https://example.com/last-frame.jpg"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt"
                ],
                "example": {
                  "videoTime": 10,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageUrl": "https://example.com/source-image.jpg",
                  "resolution": "1080p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 10,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageUrl": "https://example.com/source-image.jpg",
                "resolution": "1080p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "kling-3-omni-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_kling_3_omni_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/wan-2-6-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Wan 2.6 Video Generation",
        "description": "Generate a Wan 2.6 video from a required primary image with optional camera control. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runWan26VideoGeneration",
        "externalDocs": {
          "description": "Wan 2.6 Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/wan-2-6-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a Wan 2.6 video from a required primary image with optional camera control.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 5, 10, 15.",
                    "example": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 720p, 1080p.",
                    "example": "1080p"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the required first-frame or primary reference image.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "camera": {
                    "type": "string",
                    "description": "Camera mode. Supported values: single or multi.",
                    "example": "single"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt",
                  "imageUrl"
                ],
                "example": {
                  "videoTime": 10,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageUrl": "https://example.com/source-image.jpg",
                  "resolution": "1080p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 10,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageUrl": "https://example.com/source-image.jpg",
                "resolution": "1080p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "wan-2-6-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_wan_2_6_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/hailuo-2-3-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Hailuo 2.3 Video Generation",
        "description": "Generate a Hailuo 2.3 video from a required primary image; the aspect ratio is adaptive. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runHailuo23VideoGeneration",
        "externalDocs": {
          "description": "Hailuo 2.3 Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/hailuo-2-3-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a Hailuo 2.3 video from a required primary image; the aspect ratio is adaptive.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 6, 10.",
                    "example": 6
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 768p, 1080p.",
                    "example": "1080p"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the required first-frame or primary reference image.",
                    "example": "https://example.com/source-image.jpg"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt",
                  "resolution",
                  "imageUrl"
                ],
                "example": {
                  "videoTime": 6,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageUrl": "https://example.com/source-image.jpg",
                  "resolution": "1080p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 6,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageUrl": "https://example.com/source-image.jpg",
                "resolution": "1080p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "hailuo-2-3-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_hailuo_2_3_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/happy-horse-2-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Happy Horse 2 Video Generation",
        "description": "Generate a Happy Horse 2 video from 1 to 9 required reference images. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runHappyHorse2VideoGeneration",
        "externalDocs": {
          "description": "Happy Horse 2 Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/happy-horse-2-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a Happy Horse 2 video from 1 to 9 required reference images.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 5, 10, 15.",
                    "example": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 720p, 1080p.",
                    "example": "1080p"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 9 images.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 9
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: 9:16, 16:9.",
                    "example": "9:16"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt",
                  "resolution",
                  "imageList"
                ],
                "example": {
                  "videoTime": 10,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageList": [
                    "https://example.com/product.jpg",
                    "https://example.com/ref-2.jpg"
                  ],
                  "resolution": "1080p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 10,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageList": [
                  "https://example.com/product.jpg",
                  "https://example.com/ref-2.jpg"
                ],
                "resolution": "1080p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "happy-horse-2-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_happy_horse_2_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-brand-products/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Brand Products",
        "description": "Nexscope Ozon Russia brand drill-down product list. Returns all products under an Ozon brand display name (Russian/Latin) with complete metrics: sales, revenue, price, rating, stock, turnover, lost revenue, supporting multi-dimensional numeric filters, sorting, and currency conversion. Use for brand benchmarking, competitor analysis, brand product structure research, SKU-level bestseller analysis. Trigger when the user mentions Ozon brand drill-down, Ozon brand products, Ozon competitor brand analysis, brand structure, brand SKUs, brand bestsellers, Ozon brand sales, Nexscope brand, Ozon brand products, brand drill-down, brand competitor analysis, Russian marketplace brand SKUs, brand revenue share. Also trigger when the intent is to view all products and their sales/price/rating performance under an Ozon brand, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonBrandProducts",
        "externalDocs": {
          "description": "Ozon Brand Products documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-brand-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-brand-products.",
                "properties": {
                  "brandName": {
                    "type": "string",
                    "description": "Ozon brand display name (Russian or Latin)",
                    "example": "COMMO"
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Statistics start date, YYYY-MM-DD; latest is yesterday",
                    "example": "2026-01-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "Statistics end date, YYYY-MM-DD; latest is yesterday",
                    "example": "2026-01-01"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting from 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Rows per page, 1-100, default 100",
                    "example": 10
                  },
                  "sortField": {
                    "type": "string",
                    "description": "Sort column name (snake_case), e.g., sales, revenue, final_price, balance, rating"
                  },
                  "sortDirection": {
                    "type": "string",
                    "description": "asc ascending / desc descending"
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency code for result amounts, default RUB, e.g., USD / EUR / CNY"
                  },
                  "currencyRate": {
                    "type": "integer",
                    "description": "Custom exchange rate (for non-default currency)",
                    "example": 1
                  },
                  "includeFbs": {
                    "type": "boolean",
                    "description": "Whether to include FBS data",
                    "example": false
                  },
                  "filters": {
                    "type": "array",
                    "items": {},
                    "description": "List of numeric filter conditions, each {field, op, value, value2?}, multiple conditions AND",
                    "example": []
                  }
                },
                "required": [
                  "brandName"
                ],
                "example": {
                  "startDate": "2026-01-01",
                  "currencyRate": 1,
                  "brandName": "COMMO",
                  "page": 1,
                  "endDate": "2026-01-31",
                  "pageSize": 10,
                  "includeFbs": false
                },
                "additionalProperties": true
              },
              "example": {
                "startDate": "2026-01-01",
                "currencyRate": 1,
                "brandName": "COMMO",
                "page": 1,
                "endDate": "2026-01-31",
                "pageSize": 10,
                "includeFbs": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matched products under the brand",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "integer",
                                        "description": "SKU ID",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product name (Russian)",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "brandId": {
                                        "type": "integer",
                                        "description": "Brand ID",
                                        "example": 1
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "integer",
                                        "description": "Seller ID",
                                        "example": 1
                                      },
                                      "category": {
                                        "type": "string",
                                        "description": "Category path (Russian, / separated)",
                                        "example": null
                                      },
                                      "nicheName": {
                                        "type": "string",
                                        "description": "Niche path (Russian)",
                                        "example": null
                                      },
                                      "nicheId": {
                                        "type": "integer",
                                        "description": "Niche ID",
                                        "example": 1
                                      },
                                      "country": {
                                        "type": "string",
                                        "description": "Country of sale, always RU for Ozon",
                                        "example": null
                                      },
                                      "firstDate": {
                                        "type": "string",
                                        "description": "Listing date (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Product page URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source identifier",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current selling price",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "Original price before discount",
                                        "example": 1
                                      },
                                      "ozonCardPrice": {
                                        "type": "number",
                                        "description": "Ozon Card price",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum price during the statistics period",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Maximum price during the statistics period",
                                        "example": 1
                                      },
                                      "averagePrice": {
                                        "type": "number",
                                        "description": "Average price during the statistics period",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency symbol (₽ / $ / €)",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating, 0-5",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "balance": {
                                        "type": "integer",
                                        "description": "Current stock (units)",
                                        "example": 1
                                      },
                                      "balanceFbs": {
                                        "type": "integer",
                                        "description": "FBS stock (seller self-ship units)",
                                        "example": 1
                                      },
                                      "frozenStocks": {
                                        "type": "integer",
                                        "description": "Slow-moving stock",
                                        "example": 1
                                      },
                                      "warehousesCount": {
                                        "type": "integer",
                                        "description": "Number of FBO warehouses",
                                        "example": 1
                                      },
                                      "isFbs": {
                                        "type": "boolean",
                                        "description": "Whether shipped via FBS",
                                        "example": false
                                      },
                                      "salesPerDay": {
                                        "type": "number",
                                        "description": "Average daily sales (units/day)",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Sales volume during the statistics period (units)",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Sales revenue during the statistics period",
                                        "example": 1
                                      },
                                      "lostProfit": {
                                        "type": "number",
                                        "description": "Lost revenue (due to stockouts, etc.)",
                                        "example": 1
                                      },
                                      "daysInSite": {
                                        "type": "integer",
                                        "description": "Days on sale (statistics period, including out-of-stock days)",
                                        "example": 1
                                      },
                                      "daysInStock": {
                                        "type": "integer",
                                        "description": "Days in stock",
                                        "example": 1
                                      },
                                      "turnoverDays": {
                                        "type": "number",
                                        "description": "Turnover days (lower is faster)",
                                        "example": 1
                                      },
                                      "position": {
                                        "type": "integer",
                                        "description": "Ranking within the current query dimension (brand for this endpoint)",
                                        "example": 1
                                      },
                                      "categoryPosition": {
                                        "type": "integer",
                                        "description": "Ranking within the category",
                                        "example": 1
                                      },
                                      "revenueSharePercent": {
                                        "type": "number",
                                        "description": "Revenue share of this SKU within the current query dimension, 0-100",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": 1,
                        "brandId": 1,
                        "sellerId": 1,
                        "nicheId": 1,
                        "firstDate": "2026-01-01",
                        "imageUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "price": 1,
                        "oldPrice": 1,
                        "ozonCardPrice": 1,
                        "minPrice": 1,
                        "maxPrice": 1,
                        "averagePrice": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "balance": 1,
                        "balanceFbs": 1,
                        "frozenStocks": 1,
                        "warehousesCount": 1,
                        "isFbs": false,
                        "salesPerDay": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "lostProfit": 1,
                        "daysInSite": 1,
                        "daysInStock": 1,
                        "turnoverDays": 1,
                        "position": 1,
                        "categoryPosition": 1,
                        "revenueSharePercent": 1
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-brand-products",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_brand_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-category-products/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Category Products",
        "description": "Nexscope Ozon Russia category drill-down product list by Russian category path. Returns all products in a category with complete metrics: sales, revenue, price, rating, stock, turnover, lost revenue, supporting multi-dimensional numeric filters, sorting, and currency conversion. Use for category bestseller mining, blue-ocean insight discovery, category ranking analysis, brand landscape observation. Trigger when the user mentions Ozon category drill-down, Ozon category products, Ozon blue-ocean mining, Ozon category bestsellers, Ozon category ranking, Ozon subcategory structure, Ozon niche SKUs, Nexscope category, Ozon category drill-down, Russian marketplace niche, Ozon niche mining, Ozon subcategory bestseller. Also trigger when the intent is to view all products and their sales/price/ranking performance under an Ozon category path, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonCategoryProducts",
        "externalDocs": {
          "description": "Ozon Category Products documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-category-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-category-products.",
                "properties": {
                  "categoryPath": {
                    "type": "string",
                    "description": "Full Ozon Russian category path, levels separated by /, e.g., Одежда/Женская одежда/Футболки и топы женские",
                    "example": "Электроника/Телефоны и смарт-часы/Аксессуары для смартфонов и телефонов/Чехлы для смартфонов"
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Statistics start date YYYY-MM-DD; latest is yesterday",
                    "example": "2026-01-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "Statistics end date YYYY-MM-DD; latest is yesterday",
                    "example": "2026-01-01"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting from 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Rows per page 1-100, default 100",
                    "example": 10
                  },
                  "sortField": {
                    "type": "string",
                    "description": "Sort column name (snake_case), e.g., sales, revenue, final_price, balance, rating"
                  },
                  "sortDirection": {
                    "type": "string",
                    "description": "asc / desc"
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency code, default RUB, e.g., USD"
                  },
                  "currencyRate": {
                    "type": "integer",
                    "description": "Custom exchange rate (for non-default currency)",
                    "example": 1
                  },
                  "includeFbs": {
                    "type": "boolean",
                    "description": "Whether to include FBS data",
                    "example": false
                  },
                  "filters": {
                    "type": "array",
                    "items": {},
                    "description": "List of numeric filter conditions, each {field, op, value, value2?}, multiple conditions AND",
                    "example": []
                  }
                },
                "required": [
                  "categoryPath"
                ],
                "example": {
                  "startDate": "2026-07-01",
                  "currencyRate": 1,
                  "page": 1,
                  "endDate": "2026-07-31",
                  "categoryPath": "Электроника/Телефоны и смарт-часы/Аксессуары для смартфонов и телефонов/Чехлы для смартфонов",
                  "pageSize": 10,
                  "includeFbs": false
                },
                "additionalProperties": true
              },
              "example": {
                "startDate": "2026-07-01",
                "currencyRate": 1,
                "page": 1,
                "endDate": "2026-07-31",
                "categoryPath": "Электроника/Телефоны и смарт-часы/Аксессуары для смартфонов и телефонов/Чехлы для смартфонов",
                "pageSize": 10,
                "includeFbs": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matched products under the category",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "integer",
                                        "description": "SKU ID",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product name (Russian)",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "brandId": {
                                        "type": "integer",
                                        "description": "Brand ID",
                                        "example": 1
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "integer",
                                        "description": "Seller ID",
                                        "example": 1
                                      },
                                      "category": {
                                        "type": "string",
                                        "description": "Category path (Russian, / separated)",
                                        "example": null
                                      },
                                      "nicheName": {
                                        "type": "string",
                                        "description": "Niche path (Russian)",
                                        "example": null
                                      },
                                      "nicheId": {
                                        "type": "integer",
                                        "description": "Niche ID",
                                        "example": 1
                                      },
                                      "country": {
                                        "type": "string",
                                        "description": "Country of sale, always RU for Ozon",
                                        "example": null
                                      },
                                      "firstDate": {
                                        "type": "string",
                                        "description": "Listing date (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Product page URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source identifier",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current selling price",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "Original price before discount",
                                        "example": 1
                                      },
                                      "ozonCardPrice": {
                                        "type": "number",
                                        "description": "Ozon Card price",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum price during the statistics period",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Maximum price during the statistics period",
                                        "example": 1
                                      },
                                      "averagePrice": {
                                        "type": "number",
                                        "description": "Average price during the statistics period",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency symbol (₽ / $ / €)",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating, 0-5",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "balance": {
                                        "type": "integer",
                                        "description": "Current stock (units)",
                                        "example": 1
                                      },
                                      "balanceFbs": {
                                        "type": "integer",
                                        "description": "FBS stock (seller self-ship units)",
                                        "example": 1
                                      },
                                      "frozenStocks": {
                                        "type": "integer",
                                        "description": "Slow-moving stock",
                                        "example": 1
                                      },
                                      "warehousesCount": {
                                        "type": "integer",
                                        "description": "Number of FBO warehouses",
                                        "example": 1
                                      },
                                      "isFbs": {
                                        "type": "boolean",
                                        "description": "Whether shipped via FBS",
                                        "example": false
                                      },
                                      "salesPerDay": {
                                        "type": "number",
                                        "description": "Average daily sales (units/day)",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Sales volume during the statistics period (units)",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Sales revenue during the statistics period",
                                        "example": 1
                                      },
                                      "lostProfit": {
                                        "type": "number",
                                        "description": "Lost revenue (due to stockouts, etc.)",
                                        "example": 1
                                      },
                                      "daysInSite": {
                                        "type": "integer",
                                        "description": "Days on sale (statistics period, including out-of-stock days)",
                                        "example": 1
                                      },
                                      "daysInStock": {
                                        "type": "integer",
                                        "description": "Days in stock",
                                        "example": 1
                                      },
                                      "turnoverDays": {
                                        "type": "number",
                                        "description": "Turnover days (lower is faster)",
                                        "example": 1
                                      },
                                      "position": {
                                        "type": "integer",
                                        "description": "Ranking within the current query dimension (category for this endpoint)",
                                        "example": 1
                                      },
                                      "categoryPosition": {
                                        "type": "integer",
                                        "description": "Ranking within the category",
                                        "example": 1
                                      },
                                      "revenueSharePercent": {
                                        "type": "number",
                                        "description": "Revenue share of this SKU within the current query dimension, 0-100",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": 1,
                        "brandId": 1,
                        "sellerId": 1,
                        "nicheId": 1,
                        "firstDate": "2026-01-01",
                        "imageUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "price": 1,
                        "oldPrice": 1,
                        "ozonCardPrice": 1,
                        "minPrice": 1,
                        "maxPrice": 1,
                        "averagePrice": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "balance": 1,
                        "balanceFbs": 1,
                        "frozenStocks": 1,
                        "warehousesCount": 1,
                        "isFbs": false,
                        "salesPerDay": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "lostProfit": 1,
                        "daysInSite": 1,
                        "daysInStock": 1,
                        "turnoverDays": 1,
                        "position": 1,
                        "categoryPosition": 1,
                        "revenueSharePercent": 1
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-category-products",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_category_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-category-search/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Category Search",
        "description": "Nexscope Ozon category product search: fetches the product list for a given Ozon category ID, returning category-level aggregates (total sales, total revenue, average price, average rating, seasonality) and per-product sales, price, rating, review count, brand, seller, and fulfillment method. Use for category selection analysis, category bestseller mining, category capacity and price band analysis, seasonality assessment. Trigger when the user mentions Ozon category products, Ozon category analysis, Ozon category selection, Ozon category bestsellers, Ozon category total sales, Ozon category average price, Ozon category search, Ozon category products, category best-sellers, category analysis. Also trigger when the intent is to view products and category-level summary data within an Ozon category, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonCategorySearch",
        "externalDocs": {
          "description": "Ozon Category Search documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-category-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-category-search.",
                "properties": {
                  "categoryId": {
                    "type": "string",
                    "description": "Ozon category ID, obtained from Ozon category documentation or other Nexscope Ozon tools. Format like 15621032_15621049_115951147 (multi-level categories joined by _)",
                    "example": "15621042_17028650_97011"
                  },
                  "page": {
                    "type": "object",
                    "description": "Pagination & sorting: {page, pageSize, orders[]}",
                    "example": {
                      "page": 1,
                      "pageSize": 10
                    },
                    "properties": {
                      "page": {
                        "type": "integer",
                        "description": "Page number, starting from 1, default 1",
                        "example": 1
                      },
                      "pageSize": {
                        "type": "integer",
                        "description": "Items per page, default 20, maximum 20 (exceeding returns errcode 1002)",
                        "example": 1
                      },
                      "orders": {
                        "type": "array",
                        "items": {},
                        "description": "Sort rules, elements {field, direction} (both required); direction takes DESC (descending) / ASC (ascending). Common sort fields: sales, price, revenue, reviewRating",
                        "example": []
                      }
                    },
                    "additionalProperties": true
                  },
                  "date": {
                    "type": "string",
                    "description": "Query historical month, format yyyy-MM (e.g., 2026-02); defaults to last 30 days if omitted",
                    "example": "2026-01"
                  },
                  "fulfillment": {
                    "type": "string",
                    "description": "Fulfillment method filter, fixed options: FBO, FBS, RFBS, FBP, OZON; queries all if omitted. Note: single string, not an array"
                  },
                  "uId": {
                    "type": "string",
                    "description": "User ID (max 1000)",
                    "example": "example-id"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000)",
                    "example": "example-id"
                  }
                },
                "required": [
                  "categoryId",
                  "page"
                ],
                "example": {
                  "page": {
                    "page": 1,
                    "pageSize": 10
                  },
                  "categoryId": "15621042_17028650_97011",
                  "date": "2026-01"
                },
                "additionalProperties": true
              },
              "example": {
                "page": {
                  "page": 1,
                  "pageSize": 10
                },
                "categoryId": "15621042_17028650_97011",
                "date": "2026-01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Echoed category ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records returned on this page (equals the current page data count, not total category product count)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSales": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total category sales volume (within the statistics interval)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalRevenue": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Total category sales revenue (RUB)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "avgPrice": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Average category product price (RUB)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rating": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Average category product rating",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "startDate": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Statistics start date",
                                  "example": "2026-01-01"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "endDate": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Statistics end date",
                                  "example": "2026-01-01"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sellerType": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "description": "Fulfillment method distribution (not seller domestic/cross-border type), keys are fulfillment methods and values are product counts for that method, e.g., {\"FBO\":218,\"RFBS\":528,\"FBP\":5,\"FBS\":240,\"OZON\":1}",
                                  "example": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "categoryInfo": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "description": "Category metadata, structure see \"categoryInfo Structure\" below",
                                  "example": {},
                                  "properties": {
                                    "cnTitlePath": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "Chinese category path, for example Footwear > Athletic and Work Shoes > Weightlifting Shoes",
                                          "example": null
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "enTitlePath": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "English category path, e.g., Footwear > Sports and Work Footwear > Weightlifting Shoes",
                                          "example": null
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "titlePath": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "description": "Russian (front-end) category path, e.g., Обувь > Спортивная и рабочая обувь > Штангетки",
                                          "example": null
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "fullCategoryId": {
                                      "anyOf": [
                                        {
                                          "type": "array",
                                          "description": "Array of category IDs at each level, e.g., [\"15621032\",\"15621032_15621049\",\"15621032_15621049_115951147\"]",
                                          "example": []
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "category": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "description": "Terminal category object, containing cnTitle/enTitle/title(Russian)/level/crossBorderSellable(whether cross-border sales are allowed)/pid/disabled/id",
                                          "example": {}
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Category product list (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "sku": {
                                        "type": "integer",
                                        "description": "Product SKU",
                                        "example": 1
                                      },
                                      "productId": {
                                        "type": "integer",
                                        "description": "Unified product ID, mapped from sku",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Product price (RUB)",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency, always ₽",
                                        "example": null
                                      },
                                      "sales": {
                                        "type": "integer",
                                        "description": "Product sales volume",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Unified monthly sales, mapped from sales",
                                        "example": 1
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Product sales revenue",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Unified monthly revenue, mapped from revenue",
                                        "example": 1
                                      },
                                      "reviewRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Unified rating, mapped from reviewRating",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "brandName": {
                                        "type": "string",
                                        "description": "Brand name",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Unified brand, mapped from brandName",
                                        "example": null
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "fulfillment": {
                                        "type": "array",
                                        "description": "Product fulfillment methods, e.g., [\"FBO\"], may contain multiple values",
                                        "example": []
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productUrl": {
                                        "type": "string",
                                        "description": "Product URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Unified product page URL, mapped from productUrl",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "categoryInfo": {
                                        "type": "object",
                                        "description": "Product category attribution information, structure see \"categoryInfo Structure\" below",
                                        "example": {}
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source, always ozon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier for the Ozon category endpoint",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Category product list, content identical to data",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "seasonalityAmplitude": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "description": "Seasonality intensity, e.g., STRONG_SEASONALITY",
                                            "example": null
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "seasonalityCoef": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "description": "Seasonality phase, e.g., OFF_SEASON",
                                            "example": null
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "sku": {
                                        "type": "integer",
                                        "description": "Product SKU",
                                        "example": 1
                                      },
                                      "productId": {
                                        "type": "integer",
                                        "description": "Unified product ID, mapped from sku",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Product price (RUB)",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency, always ₽",
                                        "example": null
                                      },
                                      "sales": {
                                        "type": "integer",
                                        "description": "Product sales volume",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Unified monthly sales, mapped from sales",
                                        "example": 1
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Product sales revenue",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Unified monthly revenue, mapped from revenue",
                                        "example": 1
                                      },
                                      "reviewRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Unified rating, mapped from reviewRating",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "brandName": {
                                        "type": "string",
                                        "description": "Brand name",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Unified brand, mapped from brandName",
                                        "example": null
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "fulfillment": {
                                        "type": "array",
                                        "description": "Product fulfillment methods, e.g., [\"FBO\"], may contain multiple values",
                                        "example": []
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productUrl": {
                                        "type": "string",
                                        "description": "Product URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Unified product page URL, mapped from productUrl",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "categoryInfo": {
                                        "type": "object",
                                        "description": "Product category attribution information, structure see \"categoryInfo Structure\" below",
                                        "example": {}
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source, always ozon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier for the Ozon category endpoint",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "hasNextPage": {
                              "anyOf": [
                                {
                                  "type": "boolean",
                                  "description": "Whether there is a next page",
                                  "example": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions, elements contain {field, title, cellType, sortable, filterable}",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response display type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "id": "example-id",
                    "total": 1,
                    "totalSales": 1,
                    "totalRevenue": 1,
                    "avgPrice": 1,
                    "rating": 1,
                    "startDate": "2026-01-01",
                    "endDate": "2026-01-01",
                    "sellerType": {},
                    "categoryInfo": {
                      "fullCategoryId": [],
                      "category": {}
                    },
                    "data": [
                      {
                        "sku": 1,
                        "productId": 1,
                        "price": 1,
                        "sales": 1,
                        "monthlySalesUnits": 1,
                        "revenue": 1,
                        "monthlySalesRevenue": 1,
                        "reviewRating": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "fulfillment": [],
                        "imageUrl": "https://example.com/image.jpg",
                        "productUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "categoryInfo": {}
                      }
                    ],
                    "products": [
                      {
                        "sku": 1,
                        "productId": 1,
                        "price": 1,
                        "sales": 1,
                        "monthlySalesUnits": 1,
                        "revenue": 1,
                        "monthlySalesRevenue": 1,
                        "reviewRating": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "fulfillment": [],
                        "imageUrl": "https://example.com/image.jpg",
                        "productUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "categoryInfo": {}
                      }
                    ],
                    "hasNextPage": false,
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-category-search",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_category_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-keyword-back-search/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Ozon Keyword Back Search",
        "description": "Nexscope Ozon keyword reverse lookup: reverse-looks up Ozon (and Wildberries) search keywords by a list of product SKUs (up to 20), returning which search terms those products appear under (organic/ad search terms), with multi-dimensional filtering by search volume, growth, product count, seller count, competitor count, natural rank, ad rank, exposure, conversion, cart-add conversion, etc. Each keyword carries monthly search volume, growth, market space, competitor/seller counts, average price, cart-add conversion, top products, and organic/ad channel, rank, exposure, and conversion (dimension) market profiles. Use for Ozon keyword reverse lookup, listing keyword optimization, competitor traffic word mining, and ad keyword analysis. Trigger when the user mentions Ozon keyword reverse lookup, Ozon reverse keyword search, Ozon SKU keyword reverse, Ozon product traffic keywords, Ozon competitor ranking keywords, Ozon organic/ad keyword reverse lookup, Nexscope Ozon, Ozon keyword back search, Ozon reverse keyword lookup, Ozon SKU keyword reverse. Also trigger when the intent is to reverse-lookup Ozon search keywords by product SKU and view market profiles, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonKeywordBackSearch",
        "externalDocs": {
          "description": "Ozon Keyword Back Search documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-keyword-back-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-keyword-back-search.",
                "properties": {
                  "skuIds": {
                    "type": [
                      "integer",
                      "array"
                    ],
                    "description": "List of SKUs to back-search, max 20",
                    "example": 1,
                    "items": {
                      "type": "string"
                    }
                  },
                  "hasVariant": {
                    "type": "integer",
                    "description": "Whether to exclude variants: 0 do not exclude variants, 1 exclude variants",
                    "example": 1
                  },
                  "page": {
                    "type": "object",
                    "description": "Pagination & sorting: {page, pageSize, orders[]}",
                    "example": {
                      "page": 1,
                      "pageSize": 10
                    },
                    "properties": {
                      "page": {
                        "type": "integer",
                        "description": "Page number, starting from 1, default 1",
                        "example": 1
                      },
                      "pageSize": {
                        "type": "integer",
                        "description": "Items per page, default 20",
                        "example": 1
                      },
                      "orders": {
                        "type": "array",
                        "items": {},
                        "description": "Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending)",
                        "example": []
                      }
                    },
                    "additionalProperties": true
                  },
                  "matchType": {
                    "type": "integer",
                    "description": "Keyword match mode: 0 exact, 1 fuzzy",
                    "example": 1
                  },
                  "type": {
                    "type": "array",
                    "items": {},
                    "description": "Search term type filter, fixed options: 0 organic search terms, 1 ad search terms; no filtering if omitted",
                    "example": []
                  },
                  "historyDate": {
                    "type": "string",
                    "description": "Historical month yyyy-MM (e.g., 2026-02); can be left blank per docs to query current period",
                    "example": "2026-01-01"
                  },
                  "includeKeywords": {
                    "type": "array",
                    "items": {},
                    "description": "Include keyword array (max 1000), only returns search terms containing the specified words",
                    "example": []
                  },
                  "excludeKeywords": {
                    "type": "array",
                    "items": {},
                    "description": "Exclude keyword array (max 1000), removes irrelevant terms",
                    "example": []
                  },
                  "searchVolume": {
                    "type": "string",
                    "description": "Monthly search volume range"
                  },
                  "searchChange30": {
                    "type": "string",
                    "description": "30-day search change range"
                  },
                  "wordCount": {
                    "type": "string",
                    "description": "Keyword word count range"
                  },
                  "productViews": {
                    "type": "string",
                    "description": "Product views range"
                  },
                  "products": {
                    "type": "string",
                    "description": "Product count range"
                  },
                  "sellers": {
                    "type": "string",
                    "description": "Seller count range"
                  },
                  "marketSpace": {
                    "type": "string",
                    "description": "Market space range"
                  },
                  "conversionSharing": {
                    "type": "string",
                    "description": "Conversion concentration range"
                  },
                  "uniqQueriesWCa": {
                    "type": "string",
                    "description": "Add-to-cart count range"
                  },
                  "ca": {
                    "type": "string",
                    "description": "Add-to-cart conversion rate range"
                  },
                  "conversion": {
                    "type": "string",
                    "description": "Conversion rate range"
                  },
                  "titleDensity": {
                    "type": "string",
                    "description": "Title density range"
                  },
                  "adRivalCount": {
                    "type": "string",
                    "description": "Ad competitor count range"
                  },
                  "adRank": {
                    "type": "string",
                    "description": "Ad ranking range"
                  },
                  "naturalRank": {
                    "type": "string",
                    "description": "Organic ranking range"
                  },
                  "exposure": {
                    "type": "string",
                    "description": "Exposure range"
                  },
                  "uId": {
                    "type": "string",
                    "description": "User ID",
                    "example": "example-id"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "Member ID (a unique member identifier; data is attributed to memberId)",
                    "example": "example-id"
                  }
                },
                "required": [
                  "skuIds",
                  "hasVariant",
                  "page"
                ],
                "example": {
                  "page": {
                    "page": 1,
                    "pageSize": 10
                  },
                  "skuIds": [
                    "175924376"
                  ],
                  "historyDate": "2026-01-01",
                  "type": [],
                  "matchType": 1,
                  "hasVariant": 1
                },
                "additionalProperties": true
              },
              "example": {
                "page": {
                  "page": 1,
                  "pageSize": 10
                },
                "skuIds": [
                  "175924376"
                ],
                "historyDate": "2026-01-01",
                "type": [],
                "matchType": 1,
                "hasVariant": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Keyword back-search data (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "query": {
                                        "type": "string",
                                        "description": "Keyword (original Russian)",
                                        "example": "phone case"
                                      },
                                      "queryCn": {
                                        "type": "string",
                                        "description": "Keyword Chinese translation",
                                        "example": "phone case"
                                      },
                                      "platform": {
                                        "type": "integer",
                                        "description": "Platform: 0 Ozon, 1 Wildberries",
                                        "example": 1
                                      },
                                      "searchVolume": {
                                        "type": "integer",
                                        "description": "Monthly search volume",
                                        "example": 1
                                      },
                                      "count30GrowthRate": {
                                        "type": "number",
                                        "description": "Monthly search growth (%, can be negative)",
                                        "example": 1
                                      },
                                      "productCount": {
                                        "type": "integer",
                                        "description": "Product count (may be missing in some rows)",
                                        "example": 1
                                      },
                                      "competingProducts": {
                                        "type": "integer",
                                        "description": "Competing product count",
                                        "example": 1
                                      },
                                      "sellers": {
                                        "type": "integer",
                                        "description": "Seller count",
                                        "example": 1
                                      },
                                      "avgPrice": {
                                        "type": "number",
                                        "description": "Average price",
                                        "example": 1
                                      },
                                      "itemsViews": {
                                        "type": "number",
                                        "description": "Product visibility",
                                        "example": 1
                                      },
                                      "viewSharing": {
                                        "type": "number",
                                        "description": "View concentration (%)",
                                        "example": 1
                                      },
                                      "conversionSharing": {
                                        "type": "number",
                                        "description": "Conversion concentration (%)",
                                        "example": 1
                                      },
                                      "marketSpace": {
                                        "type": "number",
                                        "description": "Market space",
                                        "example": 1
                                      },
                                      "returnCancellationRate": {
                                        "type": "number",
                                        "description": "Return/cancellation rate (%)",
                                        "example": 1
                                      },
                                      "uniqQueriesWCa": {
                                        "type": "integer",
                                        "description": "Add-to-cart count",
                                        "example": 1
                                      },
                                      "ca": {
                                        "type": "number",
                                        "description": "Add-to-cart conversion rate (%)",
                                        "example": 1
                                      },
                                      "titleDensity": {
                                        "type": "number",
                                        "description": "Title density",
                                        "example": 1
                                      },
                                      "wordCount": {
                                        "type": "integer",
                                        "description": "Word count",
                                        "example": 1
                                      },
                                      "categories": {
                                        "type": "array",
                                        "description": "Category ID array",
                                        "example": []
                                      },
                                      "dimension": {
                                        "type": "object",
                                        "description": "Dimension object, carrying back-search-specific metrics (see below)",
                                        "example": {},
                                        "properties": {
                                          "type": {
                                            "type": "integer",
                                            "description": "Search term channel: 0 organic search term, 1 ad search term",
                                            "example": 1
                                          },
                                          "naturalRank": {
                                            "type": "integer",
                                            "description": "Organic ranking (the back-searched SKU's organic position under this term)",
                                            "example": 1
                                          },
                                          "exposure": {
                                            "type": "number",
                                            "description": "Exposure (0–1)",
                                            "example": 1
                                          },
                                          "conversion": {
                                            "type": "number",
                                            "description": "Conversion rate (0–1)",
                                            "example": 1
                                          },
                                          "x": {
                                            "type": "array",
                                            "description": "Position/pagination indicator, semantics opaque",
                                            "example": []
                                          }
                                        }
                                      },
                                      "products": {
                                        "type": "array",
                                        "description": "Top product data (see below)",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "ozonId": {
                                              "type": "integer",
                                              "description": "Ozon product ID",
                                              "example": 1
                                            },
                                            "sku": {
                                              "type": "integer",
                                              "description": "SKU ID",
                                              "example": 1
                                            },
                                            "title": {
                                              "type": "string",
                                              "description": "Product title (Russian)",
                                              "example": null
                                            },
                                            "imageUrl": {
                                              "type": "string",
                                              "description": "Main image URL",
                                              "example": "https://example.com/image.jpg"
                                            },
                                            "advert": {
                                              "type": "integer",
                                              "description": "Ad indicator (0/1)",
                                              "example": 1
                                            }
                                          }
                                        }
                                      },
                                      "id": {
                                        "type": "string",
                                        "description": "Record ID",
                                        "example": "example-id"
                                      },
                                      "categoryInfos": {
                                        "type": "array",
                                        "description": "Schema-defined category information; current supplier examples omit it",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "titleCn": {
                                              "type": "string",
                                              "description": "Category Chinese name",
                                              "example": null
                                            },
                                            "titleEn": {
                                              "type": "string",
                                              "description": "Category English name",
                                              "example": null
                                            },
                                            "titleRu": {
                                              "type": "string",
                                              "description": "Category Russian name",
                                              "example": null
                                            },
                                            "cnTitlePath": {
                                              "type": "string",
                                              "description": "Chinese category path",
                                              "example": null
                                            },
                                            "enTitlePath": {
                                              "type": "string",
                                              "description": "English category path",
                                              "example": null
                                            },
                                            "titlePath": {
                                              "type": "string",
                                              "description": "Russian category path",
                                              "example": null
                                            },
                                            "id": {
                                              "type": "string",
                                              "description": "Category ID",
                                              "example": "example-id"
                                            },
                                            "crossBorderSellable": {
                                              "type": "boolean",
                                              "description": "Whether cross-border sales are allowed",
                                              "example": false
                                            }
                                          }
                                        }
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions, elements contain {field, title, cellType, sortable, filterable}",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response display type, e.g., tableListWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "query": "phone case",
                        "queryCn": "phone case",
                        "platform": 1,
                        "searchVolume": 1,
                        "count30GrowthRate": 1,
                        "productCount": 1,
                        "competingProducts": 1,
                        "sellers": 1,
                        "avgPrice": 1,
                        "itemsViews": 1,
                        "viewSharing": 1,
                        "conversionSharing": 1,
                        "marketSpace": 1,
                        "returnCancellationRate": 1,
                        "uniqQueriesWCa": 1,
                        "ca": 1,
                        "titleDensity": 1,
                        "wordCount": 1,
                        "categories": [],
                        "dimension": {
                          "type": 1,
                          "naturalRank": 1,
                          "exposure": 1,
                          "conversion": 1,
                          "x": []
                        },
                        "products": [
                          {
                            "ozonId": 1,
                            "sku": 1,
                            "imageUrl": "https://example.com/image.jpg",
                            "advert": 1
                          }
                        ],
                        "id": "example-id",
                        "categoryInfos": [
                          {
                            "id": "example-id",
                            "crossBorderSellable": false
                          }
                        ]
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-keyword-back-search",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_keyword_back_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-keyword-mining/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Ozon Keyword Mining",
        "description": "Nexscope Ozon keyword mining: mines Ozon (and Wildberries) related keywords around a seed keyword with multi-dimensional filtering by search volume, growth, product count, seller count, competitor count, price, relevancy, title density, cart-add conversion, etc. Each mined keyword carries a full market profile (monthly search volume, growth, market space, competitor/seller counts, average price, cart-add conversion, top products). Use for Ozon keyword expansion, long-tail keyword mining, and seed keyword opportunity analysis. Trigger when the user mentions Ozon keyword mining, Ozon keyword expansion, Ozon long-tail keyword mining, find related keywords around a term, Ozon blue-ocean keyword mining, Nexscope Ozon, Ozon keyword mining, Ozon keyword expansion, Ozon related keywords, mine Ozon keywords. Also trigger when the intent is to mine Ozon related keywords around a seed term and view market profiles, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonKeywordMining",
        "externalDocs": {
          "description": "Ozon Keyword Mining documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-keyword-mining"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-keyword-mining.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Seed keyword, mining expands around this term (maxLength 1000)",
                    "example": "phone case"
                  },
                  "page": {
                    "type": "object",
                    "description": "Pagination & sorting: {page, pageSize, orders[]}",
                    "example": {
                      "page": 1,
                      "pageSize": 10
                    },
                    "properties": {
                      "page": {
                        "type": "integer",
                        "description": "Page number, starting from 1, default 1",
                        "example": 1
                      },
                      "pageSize": {
                        "type": "integer",
                        "description": "Items per page, default 20",
                        "example": 1
                      },
                      "orders": {
                        "type": "array",
                        "items": {},
                        "description": "Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending)",
                        "example": []
                      }
                    },
                    "additionalProperties": true
                  },
                  "matchType": {
                    "type": "integer",
                    "description": "Keyword match mode: 0 exact, 1 fuzzy",
                    "example": 1
                  },
                  "includeKeywords": {
                    "type": "array",
                    "items": {},
                    "description": "Include keyword array (max 1000), used to further narrow down / specify required words on top of the seed term",
                    "example": []
                  },
                  "excludeKeywords": {
                    "type": "array",
                    "items": {},
                    "description": "Exclude keyword array (max 1000), used to remove irrelevant terms",
                    "example": []
                  },
                  "wordCount": {
                    "type": "string",
                    "description": "Keyword word count range"
                  },
                  "searchVolume": {
                    "type": "string",
                    "description": "Search volume range"
                  },
                  "searchChange30": {
                    "type": "string",
                    "description": "30-day search change range"
                  },
                  "productViews": {
                    "type": "string",
                    "description": "Product views range"
                  },
                  "products": {
                    "type": "string",
                    "description": "Product count range"
                  },
                  "sellers": {
                    "type": "string",
                    "description": "Seller count range"
                  },
                  "price": {
                    "type": "string",
                    "description": "Price range"
                  },
                  "marketSpace": {
                    "type": "string",
                    "description": "Market space range"
                  },
                  "conversionSharing": {
                    "type": "string",
                    "description": "Conversion concentration range"
                  },
                  "relevancy": {
                    "type": "string",
                    "description": "Relevance range (degree of relevance to the seed keyword)"
                  },
                  "uniqQueriesWCa": {
                    "type": "string",
                    "description": "Add-to-cart count range"
                  },
                  "ca": {
                    "type": "string",
                    "description": "Add-to-cart conversion rate range"
                  },
                  "titleDensity": {
                    "type": "string",
                    "description": "Title density range"
                  },
                  "adRivalCount": {
                    "type": "string",
                    "description": "Ad competitor count range"
                  },
                  "uId": {
                    "type": "string",
                    "description": "User ID",
                    "example": "example-id"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "Member ID (a unique member identifier; data is attributed to memberId)",
                    "example": "example-id"
                  }
                },
                "required": [
                  "keyword",
                  "page"
                ],
                "example": {
                  "uId": "example-id",
                  "page": {
                    "page": 1,
                    "pageSize": 10
                  },
                  "includeKeywords": [],
                  "keyword": "phone case",
                  "excludeKeywords": [],
                  "matchType": 1
                },
                "additionalProperties": true
              },
              "example": {
                "uId": "example-id",
                "page": {
                  "page": 1,
                  "pageSize": 10
                },
                "includeKeywords": [],
                "keyword": "phone case",
                "excludeKeywords": [],
                "matchType": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Keyword mining data (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "query": {
                                        "type": "string",
                                        "description": "Keyword (original Russian)",
                                        "example": "phone case"
                                      },
                                      "queryCn": {
                                        "type": "string",
                                        "description": "Keyword Chinese translation",
                                        "example": "phone case"
                                      },
                                      "platform": {
                                        "type": "integer",
                                        "description": "Platform: 0 Ozon, 1 Wildberries",
                                        "example": 1
                                      },
                                      "searchVolume": {
                                        "type": "integer",
                                        "description": "Monthly search volume",
                                        "example": 1
                                      },
                                      "count30GrowthRate": {
                                        "type": "number",
                                        "description": "Monthly search growth (%, can be negative)",
                                        "example": 1
                                      },
                                      "productCount": {
                                        "type": "integer",
                                        "description": "Product count (may be missing in some rows)",
                                        "example": 1
                                      },
                                      "competingProducts": {
                                        "type": "integer",
                                        "description": "Competing product count",
                                        "example": 1
                                      },
                                      "sellers": {
                                        "type": "integer",
                                        "description": "Seller count",
                                        "example": 1
                                      },
                                      "avgPrice": {
                                        "type": "number",
                                        "description": "Average price",
                                        "example": 1
                                      },
                                      "itemsViews": {
                                        "type": "number",
                                        "description": "Product visibility",
                                        "example": 1
                                      },
                                      "viewSharing": {
                                        "type": "number",
                                        "description": "View concentration (%)",
                                        "example": 1
                                      },
                                      "conversionSharing": {
                                        "type": "number",
                                        "description": "Conversion concentration (%)",
                                        "example": 1
                                      },
                                      "marketSpace": {
                                        "type": "number",
                                        "description": "Market space",
                                        "example": 1
                                      },
                                      "returnCancellationRate": {
                                        "type": "number",
                                        "description": "Return/cancellation rate (%)",
                                        "example": 1
                                      },
                                      "uniqQueriesWCa": {
                                        "type": "integer",
                                        "description": "Add-to-cart count",
                                        "example": 1
                                      },
                                      "ca": {
                                        "type": "number",
                                        "description": "Add-to-cart conversion rate (%)",
                                        "example": 1
                                      },
                                      "relevancy": {
                                        "type": "number",
                                        "description": "Relevance (degree of relevance to the seed keyword)",
                                        "example": 1
                                      },
                                      "titleDensity": {
                                        "type": "number",
                                        "description": "Title density",
                                        "example": 1
                                      },
                                      "wordCount": {
                                        "type": "integer",
                                        "description": "Word count",
                                        "example": 1
                                      },
                                      "categories": {
                                        "type": "array",
                                        "description": "Category ID array",
                                        "example": []
                                      },
                                      "categoryInfos": {
                                        "type": "array",
                                        "description": "Category information (see below)",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "titleCn": {
                                              "type": "string",
                                              "description": "Category Chinese name",
                                              "example": null
                                            },
                                            "titleEn": {
                                              "type": "string",
                                              "description": "Category English name",
                                              "example": null
                                            },
                                            "titleRu": {
                                              "type": "string",
                                              "description": "Category Russian name",
                                              "example": null
                                            },
                                            "cnTitlePath": {
                                              "type": "string",
                                              "description": "Chinese category path",
                                              "example": null
                                            },
                                            "enTitlePath": {
                                              "type": "string",
                                              "description": "English category path",
                                              "example": null
                                            },
                                            "titlePath": {
                                              "type": "string",
                                              "description": "Russian category path",
                                              "example": null
                                            },
                                            "id": {
                                              "type": "string",
                                              "description": "Category ID",
                                              "example": "example-id"
                                            },
                                            "crossBorderSellable": {
                                              "type": "boolean",
                                              "description": "Whether cross-border sales are allowed",
                                              "example": false
                                            }
                                          }
                                        }
                                      },
                                      "products": {
                                        "type": "array",
                                        "description": "Top product data (see below)",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "ozonId": {
                                              "type": "integer",
                                              "description": "Ozon product ID",
                                              "example": 1
                                            },
                                            "sku": {
                                              "type": "integer",
                                              "description": "SKU ID",
                                              "example": 1
                                            },
                                            "title": {
                                              "type": "string",
                                              "description": "Product title (Russian)",
                                              "example": null
                                            },
                                            "imageUrl": {
                                              "type": "string",
                                              "description": "Main image URL",
                                              "example": "https://example.com/image.jpg"
                                            },
                                            "advert": {
                                              "type": "integer",
                                              "description": "Ad indicator (0/1)",
                                              "example": 1
                                            }
                                          }
                                        }
                                      },
                                      "id": {
                                        "type": "string",
                                        "description": "Record ID",
                                        "example": "example-id"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions, elements contain {field, title, cellType, sortable, filterable}",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response display type, e.g., tableListWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "query": "phone case",
                        "queryCn": "phone case",
                        "platform": 1,
                        "searchVolume": 1,
                        "count30GrowthRate": 1,
                        "productCount": 1,
                        "competingProducts": 1,
                        "sellers": 1,
                        "avgPrice": 1,
                        "itemsViews": 1,
                        "viewSharing": 1,
                        "conversionSharing": 1,
                        "marketSpace": 1,
                        "returnCancellationRate": 1,
                        "uniqQueriesWCa": 1,
                        "ca": 1,
                        "relevancy": 1,
                        "titleDensity": 1,
                        "wordCount": 1,
                        "categories": [],
                        "categoryInfos": [
                          {
                            "id": "example-id",
                            "crossBorderSellable": false
                          }
                        ],
                        "products": [
                          {
                            "ozonId": 1,
                            "sku": 1,
                            "imageUrl": "https://example.com/image.jpg",
                            "advert": 1
                          }
                        ],
                        "id": "example-id"
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-keyword-mining",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_keyword_mining",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-market-keyword-search/run": {
      "post": {
        "tags": [
          "Keyword & Search Demand"
        ],
        "summary": "Ozon Market Keyword Search",
        "description": "Nexscope Ozon market hot keyword search: filters Ozon (and Wildberries) market keywords by multi-dimensional metrics including search volume, growth, product count, seller count, competitor count, price, sales, conversion concentration, etc. Each keyword carries monthly search volume, growth, market space, competitor/seller counts, average price, cart-add conversion, top products, and market profile. Use for Ozon keyword selection, blue-ocean keyword mining, and market opportunity analysis. Trigger when the user mentions Ozon hot keywords, Ozon keyword market analysis, Ozon keyword selection, Ozon blue-ocean keywords, Ozon search volume, Wildberries keywords, Nexscope Ozon, Ozon market keyword search, Ozon keyword research, blue ocean keywords Ozon. Also trigger when the intent is to filter Ozon market keywords by metrics and view market profiles, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonMarketKeywordSearch",
        "externalDocs": {
          "description": "Ozon Market Keyword Search documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-market-keyword-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-market-keyword-search.",
                "properties": {
                  "page": {
                    "type": "object",
                    "description": "Pagination & sorting: {page, pageSize, orders[]}",
                    "example": {
                      "page": 1,
                      "pageSize": 10
                    },
                    "properties": {
                      "page": {
                        "type": "integer",
                        "description": "Page number, starting from 1, default 1",
                        "example": 1
                      },
                      "pageSize": {
                        "type": "integer",
                        "description": "Items per page, default 20",
                        "example": 1
                      },
                      "orders": {
                        "type": "array",
                        "items": {},
                        "description": "Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending)",
                        "example": []
                      }
                    },
                    "additionalProperties": true
                  },
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Keyword array (max 1000), used with matchType",
                    "example": []
                  },
                  "matchType": {
                    "type": "integer",
                    "description": "Keyword match mode: 0 exact, 1 fuzzy",
                    "example": 1
                  },
                  "searchDate": {
                    "type": "string",
                    "description": "Query date yyyy-MM-dd (e.g., 2026-04-01); defaults to last 30 days if omitted; passing 2026-04-01 queries March 2026 data",
                    "example": "2026-01-01"
                  },
                  "categories": {
                    "type": "array",
                    "items": {},
                    "description": "Category ID array (max 1000)",
                    "example": []
                  },
                  "searchVolume": {
                    "type": "object",
                    "description": "Search volume range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "searchChange30": {
                    "type": "object",
                    "description": "30-day search change range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "monthlySales": {
                    "type": "object",
                    "description": "Monthly sales range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "monthlyRevenue": {
                    "type": "object",
                    "description": "Monthly revenue range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "price": {
                    "type": "object",
                    "description": "Price range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "productViews": {
                    "type": "object",
                    "description": "Product views range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "products": {
                    "type": "object",
                    "description": "Product count range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "volume": {
                    "type": "object",
                    "description": "Volume range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "marketSpace": {
                    "type": "object",
                    "description": "Market space range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "conversionSharing": {
                    "type": "object",
                    "description": "Conversion concentration range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "reviews": {
                    "type": "object",
                    "description": "Review count range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "ratings": {
                    "type": "object",
                    "description": "Rating range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "sellers": {
                    "type": "object",
                    "description": "Seller count range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "weight": {
                    "type": "object",
                    "description": "Weight range {min,max}",
                    "example": {
                      "min": 1
                    },
                    "properties": {
                      "min": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": true
                  },
                  "uId": {
                    "type": "string",
                    "description": "User ID",
                    "example": "example-id"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "Member ID (a unique member identifier; data is attributed to memberId)",
                    "example": "example-id"
                  }
                },
                "required": [
                  "page"
                ],
                "example": {
                  "searchDate": "2026-01-01",
                  "page": {
                    "page": 1,
                    "pageSize": 10
                  },
                  "keywords": [
                    "phone case"
                  ],
                  "uId": "example-id",
                  "matchType": 1,
                  "categories": []
                },
                "additionalProperties": true
              },
              "example": {
                "searchDate": "2026-01-01",
                "page": {
                  "page": 1,
                  "pageSize": 10
                },
                "keywords": [
                  "phone case"
                ],
                "uId": "example-id",
                "matchType": 1,
                "categories": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Market hot keyword data (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "query": {
                                        "type": "string",
                                        "description": "Keyword (original Russian)",
                                        "example": "phone case"
                                      },
                                      "queryCn": {
                                        "type": "string",
                                        "description": "Keyword Chinese translation",
                                        "example": "phone case"
                                      },
                                      "platform": {
                                        "type": "integer",
                                        "description": "Platform: 0 Ozon, 1 Wildberries",
                                        "example": 1
                                      },
                                      "searchVolume": {
                                        "type": "integer",
                                        "description": "Monthly search volume",
                                        "example": 1
                                      },
                                      "count30GrowthRate": {
                                        "type": "number",
                                        "description": "Monthly search growth (%, can be negative)",
                                        "example": 1
                                      },
                                      "productCount": {
                                        "type": "integer",
                                        "description": "Product count (may be missing in some rows)",
                                        "example": 1
                                      },
                                      "competingProducts": {
                                        "type": "integer",
                                        "description": "Competing product count",
                                        "example": 1
                                      },
                                      "sellers": {
                                        "type": "integer",
                                        "description": "Seller count",
                                        "example": 1
                                      },
                                      "avgPrice": {
                                        "type": "number",
                                        "description": "Average price",
                                        "example": 1
                                      },
                                      "itemsViews": {
                                        "type": "number",
                                        "description": "Product visibility",
                                        "example": 1
                                      },
                                      "viewSharing": {
                                        "type": "number",
                                        "description": "View concentration (%)",
                                        "example": 1
                                      },
                                      "conversionSharing": {
                                        "type": "number",
                                        "description": "Conversion concentration (%)",
                                        "example": 1
                                      },
                                      "marketSpace": {
                                        "type": "integer",
                                        "description": "Market space",
                                        "example": 1
                                      },
                                      "returnCancellationRate": {
                                        "type": "number",
                                        "description": "Return/cancellation rate (%)",
                                        "example": 1
                                      },
                                      "uniqQueriesWCa": {
                                        "type": "integer",
                                        "description": "Add-to-cart count",
                                        "example": 1
                                      },
                                      "ca": {
                                        "type": "number",
                                        "description": "Add-to-cart conversion rate (%)",
                                        "example": 1
                                      },
                                      "categories": {
                                        "type": "array",
                                        "description": "Category ID array",
                                        "example": []
                                      },
                                      "categoryInfos": {
                                        "type": "array",
                                        "description": "Category information (see below)",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "titleCn": {
                                              "type": "string",
                                              "description": "Category Chinese name",
                                              "example": null
                                            },
                                            "titleEn": {
                                              "type": "string",
                                              "description": "Category English name",
                                              "example": null
                                            },
                                            "titleRu": {
                                              "type": "string",
                                              "description": "Category Russian name",
                                              "example": null
                                            },
                                            "cnTitlePath": {
                                              "type": "string",
                                              "description": "Chinese category path",
                                              "example": null
                                            },
                                            "enTitlePath": {
                                              "type": "string",
                                              "description": "English category path",
                                              "example": null
                                            },
                                            "titlePath": {
                                              "type": "string",
                                              "description": "Russian category path",
                                              "example": null
                                            },
                                            "id": {
                                              "type": "string",
                                              "description": "Category ID",
                                              "example": "example-id"
                                            },
                                            "crossBorderSellable": {
                                              "type": "boolean",
                                              "description": "Whether cross-border sales are allowed",
                                              "example": false
                                            }
                                          }
                                        }
                                      },
                                      "products": {
                                        "type": "array",
                                        "description": "Top product data (see below)",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "ozonId": {
                                              "type": "integer",
                                              "description": "Ozon product ID",
                                              "example": 1
                                            },
                                            "sku": {
                                              "type": "integer",
                                              "description": "SKU ID",
                                              "example": 1
                                            },
                                            "title": {
                                              "type": "string",
                                              "description": "Product title (Russian)",
                                              "example": null
                                            },
                                            "imageUrl": {
                                              "type": "string",
                                              "description": "Main image URL",
                                              "example": "https://example.com/image.jpg"
                                            },
                                            "advert": {
                                              "type": "integer",
                                              "description": "Ad indicator (0/1)",
                                              "example": 1
                                            }
                                          }
                                        }
                                      },
                                      "id": {
                                        "type": "string",
                                        "description": "Record ID",
                                        "example": "example-id"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions, elements contain {field, title, cellType, sortable, filterable}",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response display type, e.g., tableListWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "query": "phone case",
                        "queryCn": "phone case",
                        "platform": 1,
                        "searchVolume": 1,
                        "count30GrowthRate": 1,
                        "productCount": 1,
                        "competingProducts": 1,
                        "sellers": 1,
                        "avgPrice": 1,
                        "itemsViews": 1,
                        "viewSharing": 1,
                        "conversionSharing": 1,
                        "marketSpace": 1,
                        "returnCancellationRate": 1,
                        "uniqQueriesWCa": 1,
                        "ca": 1,
                        "categories": [],
                        "categoryInfos": [
                          {
                            "id": "example-id",
                            "crossBorderSellable": false
                          }
                        ],
                        "products": [
                          {
                            "ozonId": 1,
                            "sku": 1,
                            "imageUrl": "https://example.com/image.jpg",
                            "advert": 1
                          }
                        ],
                        "id": "example-id"
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-market-keyword-search",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_market_keyword_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-product-detail/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Product Detail",
        "description": "Nexscope Ozon Russia SKU full detail query for one product ID per call, returning price, discount, Ozon Card price, rating, review count, stock, sales, revenue, revenue potential/lost revenue, listing date, images, and the complete product card.",
        "operationId": "runOzonProductDetail",
        "externalDocs": {
          "description": "Ozon Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": true,
                "properties": {
                  "endDate": {
                    "description": "Statistics end date, format YYYY-MM-DD; latest is yesterday",
                    "example": "2025-03-31",
                    "type": "string"
                  },
                  "includeFbs": {
                    "description": "Whether to include FBS data for the requested SKU",
                    "example": false,
                    "type": "boolean"
                  },
                  "productId": {
                    "description": "One Ozon product SKU as an integer or string; arrays and productIds are not accepted",
                    "example": 1786874757,
                    "type": [
                      "integer",
                      "string"
                    ]
                  },
                  "startDate": {
                    "description": "Statistics start date, format YYYY-MM-DD; latest is yesterday",
                    "example": "2025-03-01",
                    "type": "string"
                  }
                },
                "required": [
                  "productId"
                ],
                "type": "object"
              },
              "example": {
                "endDate": "2025-03-31",
                "includeFbs": false,
                "productId": 1786874757,
                "startDate": "2025-03-01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of SKUs returned (= successCount + failedCount)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "successCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of SKUs for which cards were successfully returned",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "failedCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of SKUs that failed",
                                  "example": 0
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "failures": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "List of failed SKU details (each item contains the failed productId and error info)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product card list (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "integer",
                                        "description": "SKU ID",
                                        "example": 1786874757
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product name (Russian)",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "integer",
                                        "description": "Seller ID",
                                        "example": 1
                                      },
                                      "sellerIsBestSeller": {
                                        "type": "boolean",
                                        "description": "Whether the seller is a best seller",
                                        "example": false
                                      },
                                      "nicheName": {
                                        "type": "string",
                                        "description": "Niche path (Russian, / separated)",
                                        "example": null
                                      },
                                      "nicheId": {
                                        "type": "integer",
                                        "description": "Niche ID",
                                        "example": 1
                                      },
                                      "firstDate": {
                                        "type": "string",
                                        "description": "Listing date (yyyy-MM-dd)",
                                        "example": "2025-03-01"
                                      },
                                      "updated": {
                                        "type": "string",
                                        "description": "Data update time (yyyy-MM-dd HH:mm:ss)",
                                        "example": "2025-03-31 12:00:00"
                                      },
                                      "note": {
                                        "type": "string",
                                        "description": "Notes",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source identifier",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Main image URL (first large image)",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "imageCount": {
                                        "type": "integer",
                                        "description": "Total image count",
                                        "example": 1
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Remaining large image URLs besides the main image",
                                        "example": []
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Product page URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current selling price",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "Original price before discount",
                                        "example": 1
                                      },
                                      "ozonCardPrice": {
                                        "type": "number",
                                        "description": "Ozon Card price (bank card discount price)",
                                        "example": 1
                                      },
                                      "discount": {
                                        "type": "integer",
                                        "description": "Discount, integer percentage 0-100",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency symbol (₽ / $ / €)",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating, 0-5",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "balance": {
                                        "type": "integer",
                                        "description": "Current stock (units)",
                                        "example": 1
                                      },
                                      "deliveryScheme": {
                                        "type": "string",
                                        "description": "Delivery scheme; FBO = Ozon fulfillment, FBS = seller self-delivery",
                                        "example": null
                                      },
                                      "salesPerDay": {
                                        "type": "number",
                                        "description": "Average daily sales (units/day)",
                                        "example": 1
                                      },
                                      "salesPerDayWithStock": {
                                        "type": "number",
                                        "description": "Average daily sales counting only days with stock",
                                        "example": 1
                                      },
                                      "dailySalesRevenue": {
                                        "type": "number",
                                        "description": "Average daily sales revenue",
                                        "example": 1
                                      },
                                      "dailySalesRevenueWithStock": {
                                        "type": "number",
                                        "description": "Average daily sales revenue counting only days with stock",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Sales volume during the statistics period (units)",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Sales revenue during the statistics period",
                                        "example": 1
                                      },
                                      "previousSalesUnits": {
                                        "type": "integer",
                                        "description": "Prior period sales volume (the same-length period before the current statistics period)",
                                        "example": 1
                                      },
                                      "previousRevenue": {
                                        "type": "number",
                                        "description": "Prior period sales revenue",
                                        "example": 1
                                      },
                                      "revenuePotential": {
                                        "type": "number",
                                        "description": "Potential revenue (estimated based on full-period stock availability)",
                                        "example": 1
                                      },
                                      "lostProfit": {
                                        "type": "number",
                                        "description": "Lost revenue (due to stockouts, etc.)",
                                        "example": 1
                                      },
                                      "lostProfitPercent": {
                                        "type": "number",
                                        "description": "Lost revenue percentage (%)",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "successCount": 1,
                    "failedCount": 0,
                    "failures": [],
                    "products": [
                      {
                        "productId": 1786874757,
                        "sellerId": 1,
                        "sellerIsBestSeller": false,
                        "nicheId": 1,
                        "firstDate": "2025-03-01",
                        "updated": "2025-03-31 12:00:00",
                        "imageUrl": "https://example.com/image.jpg",
                        "imageCount": 1,
                        "productImageUrls": [],
                        "productPageUrl": "https://example.com/image.jpg",
                        "price": 1,
                        "oldPrice": 1,
                        "ozonCardPrice": 1,
                        "discount": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "balance": 1,
                        "salesPerDay": 1,
                        "salesPerDayWithStock": 1,
                        "dailySalesRevenue": 1,
                        "dailySalesRevenueWithStock": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "previousSalesUnits": 1,
                        "previousRevenue": 1,
                        "revenuePotential": 1,
                        "lostProfit": 1,
                        "lostProfitPercent": 1
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-product-detail-search/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Product Detail Search",
        "description": "Nexscope Ozon product detail query: fetches the complete detail of a single Ozon product by SKU, returning title, price (RUB), rating, review count, QA count, total and daily average sales within the stats window, revenue, stock, category ranking, daily sales trend, brand, seller, fulfillment method (FBO/FBS/OZON), weight, and listing time/days/months. Use for single product deep analysis, competitor product teardown, Ozon product selection assessment, listing diagnosis, sales trend and category ranking tracking. Trigger when the user mentions Ozon product detail, Ozon single product analysis, Ozon SKU query, competitor product data, Ozon sales trend, Ozon category ranking, Ozon stock, Ozon listing time, Nexscope Ozon product search, Ozon product detail, Ozon SKU lookup, single product analysis, competitor product teardown, Ozon sales trend, category rank. Also trigger when the intent is to view detailed data of an Ozon product, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonProductDetailSearch",
        "externalDocs": {
          "description": "Ozon Product Detail Search documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-product-detail-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-product-detail-search.",
                "properties": {
                  "sku": {
                    "type": "string",
                    "description": "Product SKU (Ozon SKU, e.g., 175924376). This is the sku returned by other Nexscope Ozon tools",
                    "example": "1664362124"
                  },
                  "dateRange": {
                    "type": "string",
                    "description": "Sales/metrics statistics window, default past_30_days. Options: past_7_days / past_30_days / past_60_days / past_90_days / past_180_days / past_365_days",
                    "example": "past_30_days"
                  },
                  "uId": {
                    "type": "string",
                    "description": "User ID (max 1000)",
                    "example": "example-id"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000)",
                    "example": "example-id"
                  }
                },
                "required": [
                  "sku"
                ],
                "example": {
                  "dateRange": "past_30_days",
                  "sku": "1664362124"
                },
                "additionalProperties": true
              },
              "example": {
                "dateRange": "past_30_days",
                "sku": "1664362124"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records returned (1 on hit, 0 on miss)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSales": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total sales volume within the statistics window",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dailySales": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Average daily sales (approx totalSales / window days)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalRevenue": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Sales revenue within the statistics window (RUB)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "stock": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Stock",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "startDate": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Statistics window start date (e.g., 2026-06-01)",
                                  "example": "2026-01-01"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "endDate": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Statistics window end date (e.g., 2026-06-30)",
                                  "example": "2026-01-01"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "salesTrendVOList": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Daily sales data series (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "date": {
                                        "type": "string",
                                        "description": "Date (e.g., 2026-06-01)",
                                        "example": "2026-01-01"
                                      },
                                      "sales": {
                                        "type": "integer",
                                        "description": "Daily sales (may be 0)",
                                        "example": 1
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Daily revenue (RUB)",
                                        "example": 1
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Daily price (RUB)",
                                        "example": 1
                                      },
                                      "stock": {
                                        "type": "integer",
                                        "description": "Daily stock",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Cumulative review count as of this date",
                                        "example": 1
                                      },
                                      "reviewRating": {
                                        "type": "number",
                                        "description": "Rating as of this date",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "categoryRanks": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product category ranking history (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "date": {
                                        "type": "string",
                                        "description": "Month (e.g., 2026-02; current month shows as specific date 2026-07-01)",
                                        "example": "2026-01-01"
                                      },
                                      "rank": {
                                        "type": "integer",
                                        "description": "Category ranking",
                                        "example": 1
                                      },
                                      "count": {
                                        "type": "integer",
                                        "description": "Statistics count (subject to actual gateway interpretation)",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product detail list (1 record on single SKU hit, empty on miss)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "sku": {
                                        "type": "integer",
                                        "description": "Product SKU",
                                        "example": 1
                                      },
                                      "productId": {
                                        "type": "integer",
                                        "description": "Unified product ID, mapped from sku",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Product price (RUB)",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency, always ₽",
                                        "example": null
                                      },
                                      "reviewRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Unified rating, mapped from reviewRating",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "questionsAndAnswers": {
                                        "type": "integer",
                                        "description": "QA count",
                                        "example": 1
                                      },
                                      "brandName": {
                                        "type": "string",
                                        "description": "Brand name",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Unified brand, mapped from brandName",
                                        "example": null
                                      },
                                      "brandId": {
                                        "type": "integer",
                                        "description": "Brand ID",
                                        "example": 1
                                      },
                                      "brandUrl": {
                                        "type": "string",
                                        "description": "Brand link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "integer",
                                        "description": "Seller ID (negative values indicate Ozon platform self-operated sellers, e.g., -4 Ozon Россия)",
                                        "example": 1
                                      },
                                      "fulfillment": {
                                        "type": "array",
                                        "description": "Product fulfillment methods, e.g., [\"FBO\"], [\"OZON\"], may contain multiple values",
                                        "example": []
                                      },
                                      "upTime": {
                                        "type": "integer",
                                        "description": "Listing time, millisecond timestamp",
                                        "example": 1
                                      },
                                      "upDays": {
                                        "type": "integer",
                                        "description": "Days since listing",
                                        "example": 1
                                      },
                                      "upMonths": {
                                        "type": "integer",
                                        "description": "Months since listing",
                                        "example": 1
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Unified main image URL, mapped from the first of imageUrls",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "imageUrls": {
                                        "type": "array",
                                        "description": "List of product image URLs",
                                        "example": []
                                      },
                                      "productUrl": {
                                        "type": "string",
                                        "description": "Product URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Unified product page URL, mapped from productUrl",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "categoryInfo": {
                                        "type": "object",
                                        "description": "Product category information (see below)",
                                        "example": {},
                                        "properties": {
                                          "cnTitlePath": {
                                            "type": "string",
                                            "description": "Chinese category path",
                                            "example": null
                                          },
                                          "enTitlePath": {
                                            "type": "string",
                                            "description": "English category path",
                                            "example": null
                                          },
                                          "titlePath": {
                                            "type": "string",
                                            "description": "Category path (original text)",
                                            "example": null
                                          },
                                          "category": {
                                            "type": "object",
                                            "description": "Terminal category object (fields see below)",
                                            "example": {},
                                            "properties": {
                                              "cnTitle": {
                                                "type": "string",
                                                "description": "Category Chinese name",
                                                "example": null
                                              },
                                              "enTitle": {
                                                "type": "string",
                                                "description": "Category English name",
                                                "example": null
                                              },
                                              "title": {
                                                "type": "string",
                                                "description": "Category original title",
                                                "example": null
                                              },
                                              "level": {
                                                "type": "integer",
                                                "description": "Category level",
                                                "example": 1
                                              },
                                              "id": {
                                                "type": "string",
                                                "description": "Category ID",
                                                "example": "example-id"
                                              },
                                              "pid": {
                                                "type": "string",
                                                "description": "Parent category ID",
                                                "example": "example-id"
                                              },
                                              "crossBorderSellable": {
                                                "type": "boolean",
                                                "description": "Whether cross-border sales are supported",
                                                "example": false
                                              },
                                              "disabled": {
                                                "type": "boolean",
                                                "description": "Whether disabled",
                                                "example": false
                                              }
                                            }
                                          },
                                          "fullCategoryId": {
                                            "type": "array",
                                            "description": "Full category ID path (string array, root to terminal, e.g., [\"99999999\", \"99999999_200001489\", \"99999999_200001489_970727001\"])",
                                            "example": []
                                          }
                                        }
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Unified monthly sales, actual value equals totalSales of the current statistics window",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Unified monthly revenue, actual value equals totalRevenue of the current statistics window",
                                        "example": 1
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source, always ozon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier for the Ozon competitor-detail endpoint",
                                        "example": null
                                      },
                                      "weight": {
                                        "type": "number",
                                        "description": "Product weight, in grams (digital/service products may not return this, see field differences)",
                                        "example": 1
                                      },
                                      "grossMargin": {
                                        "type": "number",
                                        "description": "Gross margin (defined in schema, some products may not return this in practice, see field differences)",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Returned data, content identical to products",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "sku": {
                                        "type": "integer",
                                        "description": "Product SKU",
                                        "example": 1
                                      },
                                      "productId": {
                                        "type": "integer",
                                        "description": "Unified product ID, mapped from sku",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Product price (RUB)",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency, always ₽",
                                        "example": null
                                      },
                                      "reviewRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Unified rating, mapped from reviewRating",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "questionsAndAnswers": {
                                        "type": "integer",
                                        "description": "QA count",
                                        "example": 1
                                      },
                                      "brandName": {
                                        "type": "string",
                                        "description": "Brand name",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Unified brand, mapped from brandName",
                                        "example": null
                                      },
                                      "brandId": {
                                        "type": "integer",
                                        "description": "Brand ID",
                                        "example": 1
                                      },
                                      "brandUrl": {
                                        "type": "string",
                                        "description": "Brand link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "integer",
                                        "description": "Seller ID (negative values indicate Ozon platform self-operated sellers, e.g., -4 Ozon Россия)",
                                        "example": 1
                                      },
                                      "fulfillment": {
                                        "type": "array",
                                        "description": "Product fulfillment methods, e.g., [\"FBO\"], [\"OZON\"], may contain multiple values",
                                        "example": []
                                      },
                                      "upTime": {
                                        "type": "integer",
                                        "description": "Listing time, millisecond timestamp",
                                        "example": 1
                                      },
                                      "upDays": {
                                        "type": "integer",
                                        "description": "Days since listing",
                                        "example": 1
                                      },
                                      "upMonths": {
                                        "type": "integer",
                                        "description": "Months since listing",
                                        "example": 1
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Unified main image URL, mapped from the first of imageUrls",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "imageUrls": {
                                        "type": "array",
                                        "description": "List of product image URLs",
                                        "example": []
                                      },
                                      "productUrl": {
                                        "type": "string",
                                        "description": "Product URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Unified product page URL, mapped from productUrl",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "categoryInfo": {
                                        "type": "object",
                                        "description": "Product category information (see below)",
                                        "example": {},
                                        "properties": {
                                          "cnTitlePath": {
                                            "type": "string",
                                            "description": "Chinese category path",
                                            "example": null
                                          },
                                          "enTitlePath": {
                                            "type": "string",
                                            "description": "English category path",
                                            "example": null
                                          },
                                          "titlePath": {
                                            "type": "string",
                                            "description": "Category path (original text)",
                                            "example": null
                                          },
                                          "category": {
                                            "type": "object",
                                            "description": "Terminal category object (fields see below)",
                                            "example": {},
                                            "properties": {
                                              "cnTitle": {
                                                "type": "string",
                                                "description": "Category Chinese name",
                                                "example": null
                                              },
                                              "enTitle": {
                                                "type": "string",
                                                "description": "Category English name",
                                                "example": null
                                              },
                                              "title": {
                                                "type": "string",
                                                "description": "Category original title",
                                                "example": null
                                              },
                                              "level": {
                                                "type": "integer",
                                                "description": "Category level",
                                                "example": 1
                                              },
                                              "id": {
                                                "type": "string",
                                                "description": "Category ID",
                                                "example": "example-id"
                                              },
                                              "pid": {
                                                "type": "string",
                                                "description": "Parent category ID",
                                                "example": "example-id"
                                              },
                                              "crossBorderSellable": {
                                                "type": "boolean",
                                                "description": "Whether cross-border sales are supported",
                                                "example": false
                                              },
                                              "disabled": {
                                                "type": "boolean",
                                                "description": "Whether disabled",
                                                "example": false
                                              }
                                            }
                                          },
                                          "fullCategoryId": {
                                            "type": "array",
                                            "description": "Full category ID path (string array, root to terminal, e.g., [\"99999999\", \"99999999_200001489\", \"99999999_200001489_970727001\"])",
                                            "example": []
                                          }
                                        }
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Unified monthly sales, actual value equals totalSales of the current statistics window",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Unified monthly revenue, actual value equals totalRevenue of the current statistics window",
                                        "example": 1
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source, always ozon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier for the Ozon competitor-detail endpoint",
                                        "example": null
                                      },
                                      "weight": {
                                        "type": "number",
                                        "description": "Product weight, in grams (digital/service products may not return this, see field differences)",
                                        "example": 1
                                      },
                                      "grossMargin": {
                                        "type": "number",
                                        "description": "Gross margin (defined in schema, some products may not return this in practice, see field differences)",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions, elements contain {field, title, cellType, sortable, filterable}",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response display type, e.g., productWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "totalSales": 1,
                    "dailySales": 1,
                    "totalRevenue": 1,
                    "stock": 1,
                    "startDate": "2026-01-01",
                    "endDate": "2026-01-01",
                    "salesTrendVOList": [
                      {
                        "date": "2026-01-01",
                        "sales": 1,
                        "revenue": 1,
                        "price": 1,
                        "stock": 1,
                        "reviewCount": 1,
                        "reviewRating": 1
                      }
                    ],
                    "categoryRanks": [
                      {
                        "date": "2026-01-01",
                        "rank": 1,
                        "count": 1
                      }
                    ],
                    "products": [
                      {
                        "sku": 1,
                        "productId": 1,
                        "price": 1,
                        "reviewRating": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "questionsAndAnswers": 1,
                        "brandId": 1,
                        "brandUrl": "https://example.com/image.jpg",
                        "sellerId": 1,
                        "fulfillment": [],
                        "upTime": 1,
                        "upDays": 1,
                        "upMonths": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "imageUrls": [],
                        "productUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "categoryInfo": {
                          "category": {
                            "level": 1,
                            "id": "example-id",
                            "pid": "example-id",
                            "crossBorderSellable": false,
                            "disabled": false
                          },
                          "fullCategoryId": []
                        },
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "weight": 1,
                        "grossMargin": 1
                      }
                    ],
                    "data": [
                      {
                        "sku": 1,
                        "productId": 1,
                        "price": 1,
                        "reviewRating": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "questionsAndAnswers": 1,
                        "brandId": 1,
                        "brandUrl": "https://example.com/image.jpg",
                        "sellerId": 1,
                        "fulfillment": [],
                        "upTime": 1,
                        "upDays": 1,
                        "upMonths": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "imageUrls": [],
                        "productUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "categoryInfo": {
                          "category": {
                            "level": 1,
                            "id": "example-id",
                            "pid": "example-id",
                            "crossBorderSellable": false,
                            "disabled": false
                          },
                          "fullCategoryId": []
                        },
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "weight": 1,
                        "grossMargin": 1
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-product-detail-search",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_product_detail_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-product-report-search/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Product Report Search",
        "description": "Nexscope Ozon product report search: filters Ozon products by multi-dimensional metrics including sales, revenue, sales/revenue growth rate, cart conversion rate, order conversion rate, price, rating, review count, QA count, variant count, page views, gross margin, return/cancellation rate, ad spend share, weight/volume, listing time, brand, seller, fulfillment method, and labels. Returns each product's SKU, title, price (RUB), sales, revenue, lost revenue, conversion rate, rating, reviews, brand, seller, fulfillment method, listing days/months, and complete product report fields. Use for Ozon product selection, competitor product analysis, best-seller mining, price/conversion band filtering. Trigger when the user mentions Ozon product report, Ozon product selection, Ozon product filtering, Ozon product analysis, Ozon best-selling products, Ozon competitor product analysis, Ozon product report, Ozon product screener, filter Ozon products by sales, Ozon best-seller mining, Nexscope Ozon product report. Also trigger when the intent is to filter Ozon products by multiple metrics and view product-level reports, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonProductReportSearch",
        "externalDocs": {
          "description": "Ozon Product Report Search documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-product-report-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "page": {
                    "type": "object",
                    "description": "Nonempty pagination and sorting object: {page, pageSize, orders[]}. Omitted nested defaults are not inserted. Ranges accept optional finite bounds and require min <= max; numeric strings and optional null remain backend compatibility extensions.",
                    "example": {
                      "page": 1,
                      "pageSize": 10
                    }
                  },
                  "page.page": {
                    "type": "integer",
                    "description": "Page number, starting from 1, default 1",
                    "example": 1
                  },
                  "page.pageSize": {
                    "type": "integer",
                    "description": "Items per page, default 20",
                    "example": 20
                  },
                  "page.orders": {
                    "type": "array",
                    "description": "Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending). field is a metric field in the response (e.g., sales, revenue, price, reviewRating, reviewCount, salesRate)",
                    "example": [
                      {
                        "direction": "DESC",
                        "field": "sales"
                      }
                    ]
                  },
                  "skus": {
                    "type": "array",
                    "description": "SKU array (max 10), for precise lookup of specified products",
                    "example": [
                      "1664362124"
                    ]
                  },
                  "keywords": {
                    "type": "array",
                    "description": "Keyword array, filters by product title",
                    "example": []
                  },
                  "categoryIds": {
                    "type": "array",
                    "description": "Category ID array (Nexscope category IDs, not category names)",
                    "example": []
                  },
                  "sellerName": {
                    "type": "array",
                    "description": "Seller name array",
                    "example": []
                  },
                  "brand": {
                    "type": "object",
                    "description": "Brand filter: {brandName: array<string>, type: integer}; type takes 0 include brand, 1 exclude brand, 2 unbranded",
                    "example": {}
                  },
                  "fulfillment": {
                    "type": "array",
                    "description": "Fulfillment method array, fixed options: OZON, FBO, FBS, RFBS, FBP",
                    "example": []
                  },
                  "labels": {
                    "type": "array",
                    "description": "Label array, fixed options: 0 new product, 1 genuine product, 2 best seller",
                    "example": [
                      2
                    ]
                  },
                  "creationDate": {
                    "type": "integer",
                    "description": "Listing time filter (months), fixed options: 1 last 30 days, 3 last 90 days, 6 last 180 days, 12 last year, 24 last two years; no filtering if omitted",
                    "example": 1
                  },
                  "variationsMerge": {
                    "type": "integer",
                    "description": "Whether to merge variants: 0 do not merge, 1 merge",
                    "example": 1
                  },
                  "searchDate": {
                    "type": "string",
                    "description": "Query date yyyy-MM-dd (e.g., 2026-04-01); defaults to last 30 days if omitted; passing 2026-04-01 queries March 2026 data",
                    "example": "2026-01-01"
                  },
                  "tag": {
                    "type": "string",
                    "description": "Tag word",
                    "example": null
                  },
                  "uId": {
                    "type": "string",
                    "description": "User ID",
                    "example": "example-id"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "Member ID (a unique member identifier; data is attributed to memberId)",
                    "example": "example-id"
                  },
                  "monthlySales": {
                    "type": "object",
                    "description": "Monthly sales range: {min, max}; either bound may be omitted",
                    "example": {
                      "min": 5000
                    }
                  },
                  "monthlySalesRate": {
                    "type": "object",
                    "description": "Sales growth-rate range: {min, max}; either bound may be omitted",
                    "example": {
                      "min": 10
                    }
                  },
                  "monthlyRevenue": {
                    "type": "object",
                    "description": "Monthly revenue range in RUB: {min, max}; either bound may be omitted",
                    "example": {
                      "min": 100000
                    }
                  },
                  "price": {
                    "type": "object",
                    "description": "Price range in RUB: {min, max}; either bound may be omitted",
                    "example": {
                      "max": 500
                    }
                  },
                  "convToCartPdp": {
                    "type": "object",
                    "description": "Cart conversion-rate range: {min, max}; either bound may be omitted",
                    "example": {
                      "min": 20
                    }
                  },
                  "reviewRating": {
                    "type": "object",
                    "description": "Rating range from 0 to 5: {min, max}; either bound may be omitted",
                    "example": {
                      "min": 4
                    }
                  },
                  "reviewCount": {
                    "type": "object",
                    "description": "Review-count range: {min, max}; either bound may be omitted",
                    "example": {
                      "min": 100
                    }
                  },
                  "questionsAndAnswers": {
                    "type": "object",
                    "description": "Question-and-answer count range: {min, max}; either bound may be omitted",
                    "example": {
                      "min": 1
                    }
                  },
                  "variants": {
                    "type": "object",
                    "description": "Variant-count range: {min, max}; either bound may be omitted",
                    "example": {
                      "min": 1
                    }
                  },
                  "drr": {
                    "type": "object",
                    "description": "Advertising cost-share range: {min, max}; either bound may be omitted",
                    "example": {
                      "max": 20
                    }
                  },
                  "grossMargin": {
                    "type": "object",
                    "description": "Gross-margin range: {min, max}; either bound may be omitted",
                    "example": {
                      "min": 10
                    }
                  },
                  "returnCancellationRate": {
                    "type": "object",
                    "description": "Return and cancellation-rate range: {min, max}; either bound may be omitted",
                    "example": {
                      "max": 10
                    }
                  },
                  "weight": {
                    "type": "object",
                    "description": "Weight range in grams: {min, max}; either bound may be omitted",
                    "example": {
                      "max": 1000
                    }
                  },
                  "volume": {
                    "type": "object",
                    "description": "Volume range in liters: {min, max}; either bound may be omitted",
                    "example": {
                      "max": 10
                    }
                  }
                },
                "required": [
                  "page"
                ],
                "additionalProperties": true
              },
              "example": {
                "page": {
                  "page": 1,
                  "pageSize": 10
                },
                "skus": [
                  "1664362124"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total matched record count (can reach tens of millions with no filters; equals hit count when using skus precise lookup)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product report data (see details below), content identical to products",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "sku": {
                                        "type": "integer",
                                        "description": "Product SKU",
                                        "example": 1
                                      },
                                      "productId": {
                                        "type": "integer",
                                        "description": "Unified product ID (= sku)",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title (original Russian)",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productUrl": {
                                        "type": "string",
                                        "description": "Product URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Unified product page URL (= productUrl)",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency, always ₽",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source, always ozon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier for the Ozon bestseller report endpoint",
                                        "example": null
                                      },
                                      "sales": {
                                        "type": "integer",
                                        "description": "Monthly sales volume",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Unified monthly sales (= sales)",
                                        "example": 1
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Monthly sales revenue (RUB)",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Unified monthly revenue (= revenue)",
                                        "example": 1
                                      },
                                      "missedRevenue": {
                                        "type": "number",
                                        "description": "Lost revenue (RUB)",
                                        "example": 1
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Price (RUB)",
                                        "example": 1
                                      },
                                      "convToCartPdp": {
                                        "type": "number",
                                        "description": "Cart conversion rate (%)",
                                        "example": 1
                                      },
                                      "orderConversionRate": {
                                        "type": "number",
                                        "description": "Order conversion rate (%)",
                                        "example": 1
                                      },
                                      "salesRate": {
                                        "type": "number",
                                        "description": "Sales growth rate (%)",
                                        "example": 1
                                      },
                                      "revenueRate": {
                                        "type": "number",
                                        "description": "Revenue growth rate (%)",
                                        "example": 1
                                      },
                                      "drr": {
                                        "type": "number",
                                        "description": "Ad cost share (ratio)",
                                        "example": 1
                                      },
                                      "grossMargin": {
                                        "type": "number",
                                        "description": "Gross margin (%)",
                                        "example": 1
                                      },
                                      "returnCancellationRate": {
                                        "type": "number",
                                        "description": "Return/cancellation rate (%)",
                                        "example": 1
                                      },
                                      "views": {
                                        "type": "integer",
                                        "description": "Product Card Views for the searchDate period: rolling last 30 days when omitted, or the selected complete historical month. Each request retrieves the latest available Nexscope data without caching the business response. This is a periodically updated statistic, not a strictly real-time count; its refresh frequency and delay SLA are unspecified.",
                                        "example": 1
                                      },
                                      "reviewRating": {
                                        "type": "number",
                                        "description": "Rating (0~5)",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Unified rating (= reviewRating)",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "questionsAndAnswers": {
                                        "type": "integer",
                                        "description": "QA count",
                                        "example": 1
                                      },
                                      "variants": {
                                        "type": "integer",
                                        "description": "Variant count",
                                        "example": 1
                                      },
                                      "fulfillment": {
                                        "type": "array",
                                        "description": "Fulfillment methods (values OZON/FBO/FBS/RFBS/FBP)",
                                        "example": []
                                      },
                                      "weight": {
                                        "type": "number",
                                        "description": "Weight in g; the supplier does not specify whether this is packed shipping gross weight",
                                        "example": 1
                                      },
                                      "volume": {
                                        "type": "number",
                                        "description": "Volume in L; the supplier does not specify whether this is item or external parcel volume or how it is measured",
                                        "example": 1
                                      },
                                      "upTime": {
                                        "type": "integer",
                                        "description": "Listing timestamp (milliseconds)",
                                        "example": 1
                                      },
                                      "upDays": {
                                        "type": "integer",
                                        "description": "Days since listing",
                                        "example": 1
                                      },
                                      "upMonths": {
                                        "type": "integer",
                                        "description": "Months since listing",
                                        "example": 1
                                      },
                                      "brandName": {
                                        "type": "string",
                                        "description": "Brand name",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Unified brand (= brandName)",
                                        "example": null
                                      },
                                      "brandId": {
                                        "type": "integer",
                                        "description": "Brand ID",
                                        "example": 1
                                      },
                                      "brandUrl": {
                                        "type": "string",
                                        "description": "Brand link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "integer",
                                        "description": "Seller ID (may be negative for Ozon self-operated)",
                                        "example": 1
                                      },
                                      "categoryInfo": {
                                        "type": "object",
                                        "description": "Category information (see below)",
                                        "example": {},
                                        "properties": {
                                          "cnTitlePath": {
                                            "type": "string",
                                            "description": "Chinese category path",
                                            "example": null
                                          },
                                          "enTitlePath": {
                                            "type": "string",
                                            "description": "English category path",
                                            "example": null
                                          },
                                          "titlePath": {
                                            "type": "string",
                                            "description": "Russian category path",
                                            "example": null
                                          },
                                          "fullCategoryId": {
                                            "type": "array",
                                            "description": "Full category ID hierarchy array",
                                            "example": []
                                          },
                                          "category": {
                                            "type": "object",
                                            "description": "Category node: {cnTitle, enTitle, title, level, id, pid, crossBorderSellable, disabled}",
                                            "example": {}
                                          }
                                        }
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product report data (identical to data, two keys for the same data)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "sku": {
                                        "type": "integer",
                                        "description": "Product SKU",
                                        "example": 1
                                      },
                                      "productId": {
                                        "type": "integer",
                                        "description": "Unified product ID (= sku)",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title (original Russian)",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productUrl": {
                                        "type": "string",
                                        "description": "Product URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Unified product page URL (= productUrl)",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency, always ₽",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source, always ozon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier for the Ozon bestseller report endpoint",
                                        "example": null
                                      },
                                      "sales": {
                                        "type": "integer",
                                        "description": "Monthly sales volume",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Unified monthly sales (= sales)",
                                        "example": 1
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Monthly sales revenue (RUB)",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Unified monthly revenue (= revenue)",
                                        "example": 1
                                      },
                                      "missedRevenue": {
                                        "type": "number",
                                        "description": "Lost revenue (RUB)",
                                        "example": 1
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Price (RUB)",
                                        "example": 1
                                      },
                                      "convToCartPdp": {
                                        "type": "number",
                                        "description": "Cart conversion rate (%)",
                                        "example": 1
                                      },
                                      "orderConversionRate": {
                                        "type": "number",
                                        "description": "Order conversion rate (%)",
                                        "example": 1
                                      },
                                      "salesRate": {
                                        "type": "number",
                                        "description": "Sales growth rate (%)",
                                        "example": 1
                                      },
                                      "revenueRate": {
                                        "type": "number",
                                        "description": "Revenue growth rate (%)",
                                        "example": 1
                                      },
                                      "drr": {
                                        "type": "number",
                                        "description": "Ad cost share (ratio)",
                                        "example": 1
                                      },
                                      "grossMargin": {
                                        "type": "number",
                                        "description": "Gross margin (%)",
                                        "example": 1
                                      },
                                      "returnCancellationRate": {
                                        "type": "number",
                                        "description": "Return/cancellation rate (%)",
                                        "example": 1
                                      },
                                      "views": {
                                        "type": "integer",
                                        "description": "Product Card Views for the searchDate period: rolling last 30 days when omitted, or the selected complete historical month. Each request retrieves the latest available Nexscope data without caching the business response. This is a periodically updated statistic, not a strictly real-time count; its refresh frequency and delay SLA are unspecified.",
                                        "example": 1
                                      },
                                      "reviewRating": {
                                        "type": "number",
                                        "description": "Rating (0~5)",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Unified rating (= reviewRating)",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "questionsAndAnswers": {
                                        "type": "integer",
                                        "description": "QA count",
                                        "example": 1
                                      },
                                      "variants": {
                                        "type": "integer",
                                        "description": "Variant count",
                                        "example": 1
                                      },
                                      "fulfillment": {
                                        "type": "array",
                                        "description": "Fulfillment methods (values OZON/FBO/FBS/RFBS/FBP)",
                                        "example": []
                                      },
                                      "weight": {
                                        "type": "number",
                                        "description": "Weight in g; the supplier does not specify whether this is packed shipping gross weight",
                                        "example": 1
                                      },
                                      "volume": {
                                        "type": "number",
                                        "description": "Volume in L; the supplier does not specify whether this is item or external parcel volume or how it is measured",
                                        "example": 1
                                      },
                                      "upTime": {
                                        "type": "integer",
                                        "description": "Listing timestamp (milliseconds)",
                                        "example": 1
                                      },
                                      "upDays": {
                                        "type": "integer",
                                        "description": "Days since listing",
                                        "example": 1
                                      },
                                      "upMonths": {
                                        "type": "integer",
                                        "description": "Months since listing",
                                        "example": 1
                                      },
                                      "brandName": {
                                        "type": "string",
                                        "description": "Brand name",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Unified brand (= brandName)",
                                        "example": null
                                      },
                                      "brandId": {
                                        "type": "integer",
                                        "description": "Brand ID",
                                        "example": 1
                                      },
                                      "brandUrl": {
                                        "type": "string",
                                        "description": "Brand link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "integer",
                                        "description": "Seller ID (may be negative for Ozon self-operated)",
                                        "example": 1
                                      },
                                      "categoryInfo": {
                                        "type": "object",
                                        "description": "Category information (see below)",
                                        "example": {},
                                        "properties": {
                                          "cnTitlePath": {
                                            "type": "string",
                                            "description": "Chinese category path",
                                            "example": null
                                          },
                                          "enTitlePath": {
                                            "type": "string",
                                            "description": "English category path",
                                            "example": null
                                          },
                                          "titlePath": {
                                            "type": "string",
                                            "description": "Russian category path",
                                            "example": null
                                          },
                                          "fullCategoryId": {
                                            "type": "array",
                                            "description": "Full category ID hierarchy array",
                                            "example": []
                                          },
                                          "category": {
                                            "type": "object",
                                            "description": "Category node: {cnTitle, enTitle, title, level, id, pid, crossBorderSellable, disabled}",
                                            "example": {}
                                          }
                                        }
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions, elements contain {field, title, cellType, sortable, filterable}, identifying sortable/filterable fields",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response display type, e.g., productWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "sku": 1,
                        "productId": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "productUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "sales": 1,
                        "monthlySalesUnits": 1,
                        "revenue": 1,
                        "monthlySalesRevenue": 1,
                        "missedRevenue": 1,
                        "price": 1,
                        "convToCartPdp": 1,
                        "orderConversionRate": 1,
                        "salesRate": 1,
                        "revenueRate": 1,
                        "drr": 1,
                        "grossMargin": 1,
                        "returnCancellationRate": 1,
                        "views": 1,
                        "reviewRating": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "questionsAndAnswers": 1,
                        "variants": 1,
                        "fulfillment": [],
                        "weight": 1,
                        "volume": 1,
                        "upTime": 1,
                        "upDays": 1,
                        "upMonths": 1,
                        "brandId": 1,
                        "brandUrl": "https://example.com/image.jpg",
                        "sellerId": 1,
                        "categoryInfo": {
                          "fullCategoryId": [],
                          "category": {}
                        }
                      }
                    ],
                    "products": [
                      {
                        "sku": 1,
                        "productId": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "productUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "sales": 1,
                        "monthlySalesUnits": 1,
                        "revenue": 1,
                        "monthlySalesRevenue": 1,
                        "missedRevenue": 1,
                        "price": 1,
                        "convToCartPdp": 1,
                        "orderConversionRate": 1,
                        "salesRate": 1,
                        "revenueRate": 1,
                        "drr": 1,
                        "grossMargin": 1,
                        "returnCancellationRate": 1,
                        "views": 1,
                        "reviewRating": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "questionsAndAnswers": 1,
                        "variants": 1,
                        "fulfillment": [],
                        "weight": 1,
                        "volume": 1,
                        "upTime": 1,
                        "upDays": 1,
                        "upMonths": 1,
                        "brandId": 1,
                        "brandUrl": "https://example.com/image.jpg",
                        "sellerId": 1,
                        "categoryInfo": {
                          "fullCategoryId": [],
                          "category": {}
                        }
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-product-report-search",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_product_report_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-product-search/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Product Search",
        "description": "Nexscope Ozon Russia product search and reverse lookup. Searches Ozon products in the Nexscope database by Russian keyword or SKU, returning product ID, title, brand, and seller information. The entry point for Ozon product discovery and competitor analysis chains. Trigger when the user mentions Ozon product selection, Ozon product search, Russian e-commerce product selection, Ozon keyword search, Ozon SKU query, Nexscope Ozon, Ozon product search, Nexscope Ozon, Russian marketplace, Ozon SKU lookup, Ozon keyword search. Also trigger when the intent is to discover or reverse-lookup products on Ozon Russia by keyword or SKU, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonProductSearch",
        "externalDocs": {
          "description": "Ozon Product Search documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-product-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-product-search.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Russian search keyword, e.g., кроссовки (running shoes)",
                    "example": "phone case"
                  },
                  "productIds": {
                    "type": "array",
                    "items": {},
                    "description": "List of Ozon product SKUs (integer or string)",
                    "example": []
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Statistics start date, format YYYY-MM-DD; defaults to one year ago if empty; latest is yesterday",
                    "example": "2026-01-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "Statistics end date, format YYYY-MM-DD; defaults to yesterday if empty; latest is yesterday",
                    "example": "2026-01-01"
                  }
                },
                "example": {
                  "endDate": "2026-01-31",
                  "startDate": "2026-01-01",
                  "keyword": "phone case"
                },
                "additionalProperties": true
              },
              "example": {
                "endDate": "2026-01-31",
                "startDate": "2026-01-01",
                "keyword": "phone case"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total matched count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "integer",
                                        "description": "SKU ID",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product name (Russian)",
                                        "example": null
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Product page URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand name",
                                        "example": null
                                      },
                                      "brandId": {
                                        "type": "integer",
                                        "description": "Brand ID",
                                        "example": 1
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "integer",
                                        "description": "Seller ID",
                                        "example": 1
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source identifier, always ozon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier for the Ozon product-search endpoint",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": 1,
                        "productPageUrl": "https://example.com/image.jpg",
                        "imageUrl": "https://example.com/image.jpg",
                        "brandId": 1,
                        "sellerId": 1
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-product-search",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_product_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-product-trend/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Product Trend",
        "description": "Nexscope Ozon Russia single SKU daily time-series performance. Returns daily sales units, price, stock, rating, and optionally search position/visibility data for one Ozon product by date granularity. Use for validating growth trends, seasonality, and anomaly detection. Trigger when the user mentions Ozon trend, Ozon sales trend, Ozon price trend, Ozon daily data, Ozon stock trend, Ozon search ranking, Ozon product history, Nexscope trend, Ozon daily performance, Ozon time series, Ozon search visibility, Russian marketplace product history. Also trigger when the intent is to view the daily/period trend of an Ozon product, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonProductTrend",
        "externalDocs": {
          "description": "Ozon Product Trend documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-product-trend"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-product-trend.",
                "properties": {
                  "productId": {
                    "type": "integer",
                    "description": "Ozon product SKU",
                    "example": 1664362124
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Statistics start date, YYYY-MM-DD; data delayed by T-1, latest is yesterday",
                    "example": "2026-01-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "Statistics end date, YYYY-MM-DD; data delayed by T-1, latest is yesterday",
                    "example": "2026-01-01"
                  },
                  "includeFbs": {
                    "type": "boolean",
                    "description": "Whether to include FBS data",
                    "example": false
                  },
                  "includeSearchStats": {
                    "type": "boolean",
                    "description": "Whether to include search position / visibility; not supported for some niches",
                    "example": false
                  }
                },
                "required": [
                  "productId"
                ],
                "example": {
                  "includeSearchStats": false,
                  "includeFbs": false,
                  "startDate": "2026-01-01",
                  "productId": 1664362124,
                  "endDate": "2026-01-31"
                },
                "additionalProperties": true
              },
              "example": {
                "includeSearchStats": false,
                "includeFbs": false,
                "startDate": "2026-01-01",
                "productId": 1664362124,
                "endDate": "2026-01-31"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of daily data points (window days)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "List of daily data points (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "date": {
                                        "type": "string",
                                        "description": "Date, YYYY-MM-DD",
                                        "example": "2026-01-01"
                                      },
                                      "hasData": {
                                        "type": "boolean",
                                        "description": "Whether there is data for this day (false indicates a missing day, distinct from sales=0)",
                                        "example": false
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Daily selling price",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "Daily original price before discount",
                                        "example": 1
                                      },
                                      "ozonCardPrice": {
                                        "type": "number",
                                        "description": "Ozon Card price (Ozon official bank card discount price)",
                                        "example": 1
                                      },
                                      "discount": {
                                        "type": "integer",
                                        "description": "Discount, integer percentage 0-100",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency symbol (e.g., ₽ / $ / €)",
                                        "example": null
                                      },
                                      "sales": {
                                        "type": "integer",
                                        "description": "Daily sales (units)",
                                        "example": 1
                                      },
                                      "balance": {
                                        "type": "integer",
                                        "description": "Daily FBO warehouse stock (units)",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating, 0-5",
                                        "example": 1
                                      },
                                      "comments": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "isBestseller": {
                                        "type": "boolean",
                                        "description": "Whether the \"bestseller\" badge was active that day",
                                        "example": false
                                      },
                                      "isNew": {
                                        "type": "boolean",
                                        "description": "Whether the \"new product\" badge was active that day",
                                        "example": false
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "date": "2026-01-01",
                        "hasData": false,
                        "price": 1,
                        "oldPrice": 1,
                        "ozonCardPrice": 1,
                        "discount": 1,
                        "sales": 1,
                        "balance": 1,
                        "rating": 1,
                        "comments": 1,
                        "isBestseller": false,
                        "isNew": false
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-product-trend",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_product_trend",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-seller-products/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Seller Products",
        "description": "Nexscope Ozon Russia seller drill-down product list by seller ID. Returns all SKUs under a seller with complete metrics: sales, revenue, price, rating, stock, turnover, lost revenue, supporting multi-dimensional numeric filters, sorting, and currency conversion. Use for store structure analysis, seller bestseller analysis, competitor store benchmarking. Trigger when the user mentions Ozon seller products, Ozon store analysis, Ozon seller drill-down, Ozon seller SKUs, Ozon store bestsellers, Ozon competitor store, Nexscope seller, Ozon seller drill-down, Ozon shop audit, Russian marketplace seller SKUs, Ozon store structure. Also trigger when the intent is to view all products and their sales performance under an Ozon seller ID, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonSellerProducts",
        "externalDocs": {
          "description": "Ozon Seller Products documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-seller-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-seller-products.",
                "properties": {
                  "sellerId": {
                    "type": "string",
                    "description": "Ozon seller ID (numeric string), matching the seller identifier in product lists/seller rankings",
                    "example": "1581151"
                  },
                  "startDate": {
                    "type": "string",
                    "description": "Statistics start date YYYY-MM-DD; latest is yesterday",
                    "example": "2026-01-01"
                  },
                  "endDate": {
                    "type": "string",
                    "description": "Statistics end date YYYY-MM-DD; latest is yesterday",
                    "example": "2026-01-01"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, starting from 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Rows per page 1-100, default 100",
                    "example": 10
                  },
                  "sortField": {
                    "type": "string",
                    "description": "Sort column name (snake_case), e.g., sales, revenue, final_price, balance, rating"
                  },
                  "sortDirection": {
                    "type": "string",
                    "description": "asc / desc"
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency code, default RUB, e.g., USD"
                  },
                  "currencyRate": {
                    "type": "integer",
                    "description": "Custom exchange rate (for non-default currency)",
                    "example": 1
                  },
                  "includeFbs": {
                    "type": "boolean",
                    "description": "Whether to include FBS data",
                    "example": false
                  },
                  "filters": {
                    "type": "array",
                    "items": {},
                    "description": "List of numeric filter conditions, each {field, op, value, value2?}, multiple conditions AND",
                    "example": []
                  }
                },
                "required": [
                  "sellerId"
                ],
                "example": {
                  "page": 1,
                  "pageSize": 10,
                  "endDate": "2026-01-31",
                  "startDate": "2026-01-01",
                  "sellerId": "1581151",
                  "currencyRate": 1
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "pageSize": 10,
                "endDate": "2026-01-31",
                "startDate": "2026-01-01",
                "sellerId": "1581151",
                "currencyRate": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matched products under the seller",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "integer",
                                        "description": "SKU ID",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product name (Russian)",
                                        "example": null
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand",
                                        "example": null
                                      },
                                      "brandId": {
                                        "type": "integer",
                                        "description": "Brand ID",
                                        "example": 1
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "integer",
                                        "description": "Seller ID",
                                        "example": 1
                                      },
                                      "category": {
                                        "type": "string",
                                        "description": "Category path (Russian, / separated)",
                                        "example": null
                                      },
                                      "nicheName": {
                                        "type": "string",
                                        "description": "Niche path (Russian)",
                                        "example": null
                                      },
                                      "nicheId": {
                                        "type": "integer",
                                        "description": "Niche ID",
                                        "example": 1
                                      },
                                      "country": {
                                        "type": "string",
                                        "description": "Country of sale, always RU for Ozon",
                                        "example": null
                                      },
                                      "firstDate": {
                                        "type": "string",
                                        "description": "Listing date (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Product page URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source identifier",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current selling price",
                                        "example": 1
                                      },
                                      "oldPrice": {
                                        "type": "number",
                                        "description": "Original price before discount",
                                        "example": 1
                                      },
                                      "ozonCardPrice": {
                                        "type": "number",
                                        "description": "Ozon Card price",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum price during the statistics period",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Maximum price during the statistics period",
                                        "example": 1
                                      },
                                      "averagePrice": {
                                        "type": "number",
                                        "description": "Average price during the statistics period",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency symbol (₽ / $ / €)",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating, 0-5",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Number of reviews",
                                        "example": 1
                                      },
                                      "balance": {
                                        "type": "integer",
                                        "description": "Current stock (units)",
                                        "example": 1
                                      },
                                      "balanceFbs": {
                                        "type": "integer",
                                        "description": "FBS stock (seller self-ship units)",
                                        "example": 1
                                      },
                                      "frozenStocks": {
                                        "type": "integer",
                                        "description": "Slow-moving stock",
                                        "example": 1
                                      },
                                      "warehousesCount": {
                                        "type": "integer",
                                        "description": "Number of FBO warehouses",
                                        "example": 1
                                      },
                                      "isFbs": {
                                        "type": "boolean",
                                        "description": "Whether shipped via FBS",
                                        "example": false
                                      },
                                      "salesPerDay": {
                                        "type": "number",
                                        "description": "Average daily sales (units/day)",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Sales volume during the statistics period (units)",
                                        "example": 1
                                      },
                                      "monthlySalesRevenue": {
                                        "type": "number",
                                        "description": "Sales revenue during the statistics period",
                                        "example": 1
                                      },
                                      "lostProfit": {
                                        "type": "number",
                                        "description": "Lost revenue (due to stockouts, etc.)",
                                        "example": 1
                                      },
                                      "daysInSite": {
                                        "type": "integer",
                                        "description": "Days on sale (statistics period, including out-of-stock days)",
                                        "example": 1
                                      },
                                      "daysInStock": {
                                        "type": "integer",
                                        "description": "Days in stock",
                                        "example": 1
                                      },
                                      "turnoverDays": {
                                        "type": "number",
                                        "description": "Turnover days (lower is faster)",
                                        "example": 1
                                      },
                                      "position": {
                                        "type": "integer",
                                        "description": "Ranking within the current query dimension (seller for this endpoint)",
                                        "example": 1
                                      },
                                      "categoryPosition": {
                                        "type": "integer",
                                        "description": "Ranking within the category",
                                        "example": 1
                                      },
                                      "revenueSharePercent": {
                                        "type": "number",
                                        "description": "Revenue share of this SKU within the current query dimension, 0-100",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": 1,
                        "brandId": 1,
                        "sellerId": 1,
                        "nicheId": 1,
                        "firstDate": "2026-01-01",
                        "imageUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "price": 1,
                        "oldPrice": 1,
                        "ozonCardPrice": 1,
                        "minPrice": 1,
                        "maxPrice": 1,
                        "averagePrice": 1,
                        "rating": 1,
                        "reviewCount": 1,
                        "balance": 1,
                        "balanceFbs": 1,
                        "frozenStocks": 1,
                        "warehousesCount": 1,
                        "isFbs": false,
                        "salesPerDay": 1,
                        "monthlySalesUnits": 1,
                        "monthlySalesRevenue": 1,
                        "lostProfit": 1,
                        "daysInSite": 1,
                        "daysInStock": 1,
                        "turnoverDays": 1,
                        "position": 1,
                        "categoryPosition": 1,
                        "revenueSharePercent": 1
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-seller-products",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_seller_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ozon-shop-search/run": {
      "post": {
        "tags": [
          "Ozon Marketplace"
        ],
        "summary": "Ozon Shop Search",
        "description": "Nexscope Ozon shop product search: fetches the product list of an Ozon shop (seller) by shop ID, returning each product's 30-day sales, price, rating, weight, fulfillment method (FBO/FBS), seller type (local/cross-border), return/cancellation rate, and the shop's total 30-day sales. Use for competitor shop product analysis, shop bestseller mining, seller product structure analysis. Trigger when the user mentions Ozon shop products, Ozon seller product list, competitor shop analysis, Ozon shop bestsellers, Ozon seller analysis, Nexscope Ozon shop search, Ozon shop search, Ozon seller products, competitor shop analysis, Ozon store products. Also trigger when the intent is to view an Ozon shop/seller's products and sales data, even without explicitly mentioning Nexscope.",
        "operationId": "runOzonShopSearch",
        "externalDocs": {
          "description": "Ozon Shop Search documentation",
          "url": "https://www.nexscope.ai/api-docs/ozon-shop-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ozon-shop-search.",
                "properties": {
                  "id": {
                    "type": "integer",
                    "description": "Shop (seller) ID, i.e., the sellerId returned by other Nexscope Ozon tools; negative values are Ozon platform self-operated sellers (e.g., -2 Ozon Express, -4 Ozon Fresh), positive values are third-party sellers",
                    "example": 1581151
                  },
                  "page": {
                    "type": "object",
                    "description": "Pagination & sorting: {page, pageSize, orders[]}",
                    "example": {
                      "page": 1,
                      "pageSize": 10
                    },
                    "properties": {
                      "page": {
                        "type": "integer",
                        "description": "Page number, starting from 1, default 1",
                        "example": 1
                      },
                      "pageSize": {
                        "type": "integer",
                        "description": "Items per page, default 20, maximum 20 (exceeding returns errcode 1002)",
                        "example": 1
                      },
                      "orders": {
                        "type": "array",
                        "items": {},
                        "description": "Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending). Common sort fields: sales, price, reviewRating, upTime",
                        "example": []
                      }
                    },
                    "additionalProperties": true
                  },
                  "uId": {
                    "type": "string",
                    "description": "User ID (max 1000)",
                    "example": "example-id"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000)",
                    "example": "example-id"
                  }
                },
                "required": [
                  "id",
                  "page"
                ],
                "example": {
                  "id": 1581151,
                  "page": {
                    "page": 1,
                    "pageSize": 10
                  }
                },
                "additionalProperties": true
              },
              "example": {
                "id": 1581151,
                "page": {
                  "page": 1,
                  "pageSize": 10
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records returned on this page (equals the current page data count, not total shop product count)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSales": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total shop sales in the last 30 days",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalRevenue": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total shop revenue in RUB",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dailySales": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Average daily shop sales",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rating": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Shop rating, 0-5",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "productCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total products in the shop",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "fulfillment": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "description": "Shop fulfillment distribution by FBO/FBS product count",
                                  "example": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Shop product list (see details below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "integer",
                                        "description": "Unified product ID, mapped from sku",
                                        "example": 1
                                      },
                                      "sku": {
                                        "type": "integer",
                                        "description": "Product SKU",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Unified rating, mapped from reviewRating",
                                        "example": 1
                                      },
                                      "reviewRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "weight": {
                                        "type": "number",
                                        "description": "Product weight, in grams",
                                        "example": 1
                                      },
                                      "sales": {
                                        "type": "integer",
                                        "description": "Product sales in the last 30 days",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Unified monthly sales, mapped from sales",
                                        "example": 1
                                      },
                                      "upTime": {
                                        "type": "integer",
                                        "description": "Product listing time, millisecond timestamp",
                                        "example": 1
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Product price (RUB)",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency, always ₽",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Unified main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "fulfillment": {
                                        "type": "array",
                                        "description": "Product fulfillment methods, e.g., [\"FBO\"], may contain multiple values",
                                        "example": []
                                      },
                                      "sellerType": {
                                        "type": "integer",
                                        "description": "Seller type: 0 domestic, 1 cross-border",
                                        "example": 1
                                      },
                                      "returnCancellationRate": {
                                        "type": "number",
                                        "description": "Product return/cancellation rate (%)",
                                        "example": 1
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source, always ozon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier for the Ozon shop endpoint",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Shop product list, content identical to data",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "integer",
                                        "description": "Unified product ID, mapped from sku",
                                        "example": 1
                                      },
                                      "sku": {
                                        "type": "integer",
                                        "description": "Product SKU",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Unified rating, mapped from reviewRating",
                                        "example": 1
                                      },
                                      "reviewRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "weight": {
                                        "type": "number",
                                        "description": "Product weight, in grams",
                                        "example": 1
                                      },
                                      "sales": {
                                        "type": "integer",
                                        "description": "Product sales in the last 30 days",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Unified monthly sales, mapped from sales",
                                        "example": 1
                                      },
                                      "upTime": {
                                        "type": "integer",
                                        "description": "Product listing time, millisecond timestamp",
                                        "example": 1
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Product price (RUB)",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency, always ₽",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Unified main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "fulfillment": {
                                        "type": "array",
                                        "description": "Product fulfillment methods, e.g., [\"FBO\"], may contain multiple values",
                                        "example": []
                                      },
                                      "sellerType": {
                                        "type": "integer",
                                        "description": "Seller type: 0 domestic, 1 cross-border",
                                        "example": 1
                                      },
                                      "returnCancellationRate": {
                                        "type": "number",
                                        "description": "Product return/cancellation rate (%)",
                                        "example": 1
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Data source, always ozon",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier for the Ozon shop endpoint",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "hasNextPage": {
                              "anyOf": [
                                {
                                  "type": "boolean",
                                  "description": "Whether there is a next page",
                                  "example": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions, elements contain {field, title, cellType, sortable, filterable}",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response display type, e.g., productWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "totalSales": 1,
                    "totalRevenue": 1,
                    "dailySales": 1,
                    "rating": 1,
                    "productCount": 1,
                    "fulfillment": {},
                    "data": [
                      {
                        "productId": 1,
                        "sku": 1,
                        "rating": 1,
                        "reviewRating": 1,
                        "weight": 1,
                        "sales": 1,
                        "monthlySalesUnits": 1,
                        "upTime": 1,
                        "price": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "fulfillment": [],
                        "sellerType": 1,
                        "returnCancellationRate": 1
                      }
                    ],
                    "products": [
                      {
                        "productId": 1,
                        "sku": 1,
                        "rating": 1,
                        "reviewRating": 1,
                        "weight": 1,
                        "sales": 1,
                        "monthlySalesUnits": 1,
                        "upTime": 1,
                        "price": 1,
                        "imageUrl": "https://example.com/image.jpg",
                        "fulfillment": [],
                        "sellerType": 1,
                        "returnCancellationRate": 1
                      }
                    ],
                    "hasNextPage": false,
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ozon-shop-search",
        "x-nexscope-mcp-tool-name": "nexscope_ozon_shop_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-abstract-image-data/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Abstract Image Data",
        "description": "Retrieves patent abstract images (drawings) from the Nexscope (Nexscope) patent database by patent ID or publication number. Trigger when the user mentions patent abstract drawings, patent diagrams, patent figures, patent images, abstract drawing retrieval, patent image lookup, patent abstract images, patent drawings, patent illustrations, Nexscope, abstract image lookup. Also trigger when the user needs to view the drawings or figures in patent documents, even without explicitly mentioning Nexscope.",
        "operationId": "runPatentAbstractImageData",
        "externalDocs": {
          "description": "Patent Abstract Image Data documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-abstract-image-data"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.patent-abstract-image-data.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "Patent ID. At least one of patentId and patentNumber must be provided. If both are present, patentId takes precedence. Only a single value is supported; multiple values separated by commas are not allowed. Max length 60000 characters."
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "Publication/announcement number. At least one of patentId and patentNumber must be provided. If both are present, patentId takes precedence. Only a single value is supported; multiple values separated by commas are not allowed. Max length 60000 characters.",
                    "example": "US11299876B2"
                  }
                },
                "example": {
                  "patentNumber": "US11299876B2"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US11299876B2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "List of patent abstract image results",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Patent ID",
                                        "example": "example-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication (announcement) number",
                                        "example": null
                                      },
                                      "abstractDrawingPath": {
                                        "type": "string",
                                        "description": "Abstract image download path",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendered style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "example-id"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-abstract-image-data",
        "x-nexscope-mcp-tool-name": "nexscope_patent_abstract_image_data",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-claims/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Claims",
        "description": "Retrieves patent claims data from Nexscope (Nexscope). Trigger when the user mentions patent claims, claim text, independent claims, dependent claims, claim count, claims tree, claims analysis, claim scope, claim language, viewing the claims section of a specific patent, patent claims, independent claims, dependent claims, claims text, Nexscope. Also trigger when the user requests patent claims information by patent ID or publication number, even without explicitly mentioning Nexscope or Nexscope.",
        "operationId": "runPatentClaims",
        "externalDocs": {
          "description": "Patent Claims documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-claims"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.patent-claims.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "Nexscope internal patent ID. Only a single value is supported; multiple values separated by commas are not allowed. Max length 60000 characters"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "Publication/announcement number. Only a single value is supported; multiple values separated by commas are not allowed. Max length 60000 characters",
                    "example": "US11299876B2"
                  },
                  "replaceByRelated": {
                    "type": "string",
                    "description": "Whether to substitute with a family patent's claims when the current patent's claims are unavailable: 1 yes, 0 no. Max length 1000 characters"
                  }
                },
                "example": {
                  "patentNumber": "US11299876B2"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US11299876B2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Patent ID",
                                        "example": "example-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication (announcement) number",
                                        "example": null
                                      },
                                      "pnRelated": {
                                        "type": "string",
                                        "description": "Publication number of the substitute patent (only provided when a family patent substitute is used)",
                                        "example": null
                                      },
                                      "claims": {
                                        "type": "array",
                                        "description": "Claims array, containing claim text and metadata",
                                        "example": []
                                      },
                                      "claimCount": {
                                        "type": "integer",
                                        "description": "Number of claims",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendered style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "example-id",
                        "claims": [],
                        "claimCount": 1
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-claims",
        "x-nexscope-mcp-tool-name": "nexscope_patent_claims",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-cited-by/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Cited By",
        "description": "Returns cited-by counts and citing patent records for up to 100 patents.",
        "operationId": "runPatentCitedBy",
        "externalDocs": {
          "description": "Patent Cited By documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-cited-by"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Provide patentId or patentNumber. A request may contain at most 100 comma-separated patents.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "One or up to 100 comma-separated Nexscope patent IDs. Takes precedence when both identifiers are provided.",
                    "example": "patent-id"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "One or up to 100 comma-separated publication or grant numbers.",
                    "example": "US10123456B2"
                  }
                },
                "example": {
                  "patentNumber": "US10123456B2"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US10123456B2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of returned patent records.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Cited-by results.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Queried patent ID.",
                                        "example": "patent-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Queried publication number.",
                                        "example": "US10123456B2"
                                      },
                                      "citedBy3y": {
                                        "type": "integer",
                                        "description": "Citations received within three years.",
                                        "example": 1
                                      },
                                      "citedBy5y": {
                                        "type": "integer",
                                        "description": "Citations received within five years.",
                                        "example": 1
                                      },
                                      "citedBySimpleFamily": {
                                        "type": "integer",
                                        "description": "Cited patents in the simple family.",
                                        "example": null
                                      },
                                      "citedByInpadocFamily": {
                                        "type": "integer",
                                        "description": "Cited patents in the INPADOC family.",
                                        "example": null
                                      },
                                      "citedByPatsnapFamily": {
                                        "type": "integer",
                                        "description": "Cited patents in the Nexscope family.",
                                        "example": null
                                      },
                                      "citedByPatents": {
                                        "type": "array",
                                        "description": "Patents that cite the queried patent.",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Provider rendering columns.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider rendering style.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Provider-reported token cost.",
                                  "example": 6000
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "patent-id",
                        "pn": "US10123456B2",
                        "citedBy3y": 1,
                        "citedBy5y": 1,
                        "citedByPatents": []
                      }
                    ],
                    "columns": [],
                    "costToken": 6000
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-cited-by",
        "x-nexscope-mcp-tool-name": "nexscope_patent_cited_by",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-claims-translation/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Claims Translation",
        "description": "Retrieves translated patent claims from the Nexscope (Nexscope) patent database. Trigger when the user asks about patent claims, claims translation, viewing claims in specific languages (Chinese, English, or Japanese), querying patent claims by patent ID or publication number, analyzing claim text, claim translation, patent claim translation, Nexscope, patent translation. Also trigger when the user needs patent claim content in a specific language, even without explicitly mentioning translated claims.",
        "operationId": "runPatentClaimsTranslation",
        "externalDocs": {
          "description": "Patent Claims Translation documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-claims-translation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.patent-claims-translation.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "Patent ID. Only a single value is supported; multiple values separated by commas are not allowed. When both patentNumber and this are present, the patent ID takes precedence. Max length: 60000 characters"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "Publication (announcement) number. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters",
                    "example": "CN115000000A"
                  },
                  "lang": {
                    "type": "string",
                    "description": "Translation language. Supports en (English, default), cn (Chinese), jp (Japanese). Max length: 1000 characters",
                    "example": "en"
                  },
                  "replaceByRelated": {
                    "type": "integer",
                    "description": "Whether to substitute with a family patent when claims are unavailable: 1 yes, 0 no (default)",
                    "example": 1
                  }
                },
                "example": {
                  "patentNumber": "CN115000000A",
                  "lang": "en",
                  "replaceByRelated": 1
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "CN115000000A",
                "lang": "en",
                "replaceByRelated": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Patent ID",
                                        "example": "example-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication (announcement) number",
                                        "example": null
                                      },
                                      "pnRelated": {
                                        "type": "string",
                                        "description": "Publication number of the substitute patent (only provided when a family patent substitute is used)",
                                        "example": null
                                      },
                                      "claims": {
                                        "type": "string",
                                        "description": "Claims translation text",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendered style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "example-id"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-claims-translation",
        "x-nexscope-mcp-tool-name": "nexscope_patent_claims_translation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-description-data/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Description Data",
        "description": "Retrieve patent description (specification) data from the Nexscope patent database by patent ID or publication number. Triggered when users mention patent specification, patent full text, patent technical description, patent embodiment details, Nexscope specification data, patent specification, patent full text, technical description, embodiment details, Nexscope, or patent detailed description. Even if the user does not explicitly say \"Nexscope,\" this skill should be triggered whenever they need to view the complete specification/description content of one or more patents.",
        "operationId": "runPatentDescriptionData",
        "externalDocs": {
          "description": "Patent Description Data documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-description-data"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.patent-description-data.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "Patent ID (at least one of patentId and patentNumber must be provided; if both are present, patentId takes priority). Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters."
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "Publication/grant number (at least one of patentId and patentNumber must be provided; if both are present, patentId takes priority). Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters.",
                    "example": "US11299876B2"
                  },
                  "replaceByRelated": {
                    "type": "string",
                    "description": "Whether to substitute with a family patent's description when the current patent's description is unavailable: 1 Yes, 0 No. Max length: 1000 characters."
                  }
                },
                "example": {
                  "patentNumber": "US11299876B2"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US11299876B2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of patent records returned",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent list, each element contains description data",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Patent ID",
                                        "example": "example-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication (grant) number",
                                        "example": null
                                      },
                                      "pnRelated": {
                                        "type": "string",
                                        "description": "Publication number of the substitute patent (only provided when family patent substitution is used)",
                                        "example": null
                                      },
                                      "description": {
                                        "type": "array",
                                        "description": "Description content sections",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "example-id",
                        "description": []
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-description-data",
        "x-nexscope-mcp-tool-name": "nexscope_patent_description_data",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-core-bibliography/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Core Bibliography",
        "description": "Returns titles, abstracts, identifiers, dates, applicants, inventors, assignees, and classifications.",
        "operationId": "runPatentCoreBibliography",
        "externalDocs": {
          "description": "Patent Core Bibliography documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-core-bibliography"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Provide patentId or patentNumber. A request may contain at most 100 comma-separated patents.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "One or up to 100 comma-separated Nexscope patent IDs. Takes precedence when both identifiers are provided.",
                    "example": "patent-id"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "One or up to 100 comma-separated publication or grant numbers.",
                    "example": "US10123456B2"
                  }
                },
                "example": {
                  "patentNumber": "US10123456B2"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US10123456B2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of returned records.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "allRecordsCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total matching record count.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Bibliographic patent records.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Patent ID.",
                                        "example": "patent-id"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Patent title.",
                                        "example": "Wireless speaker system"
                                      },
                                      "abstractContent": {
                                        "type": "string",
                                        "description": "Patent abstract.",
                                        "example": "A wireless speaker system..."
                                      },
                                      "publicationNumber": {
                                        "type": "string",
                                        "description": "Publication number.",
                                        "example": "US10123456B2"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication or grant number.",
                                        "example": null
                                      },
                                      "country": {
                                        "type": "string",
                                        "description": "Country code.",
                                        "example": null
                                      },
                                      "publicationCountry": {
                                        "type": "string",
                                        "description": "Publication country.",
                                        "example": null
                                      },
                                      "publicationDate": {
                                        "type": "string",
                                        "description": "Publication date.",
                                        "example": null
                                      },
                                      "publicationKind": {
                                        "type": "string",
                                        "description": "Publication kind code.",
                                        "example": null
                                      },
                                      "patentType": {
                                        "type": "string",
                                        "description": "Patent type.",
                                        "example": null
                                      },
                                      "kind": {
                                        "type": "string",
                                        "description": "Patent kind code.",
                                        "example": null
                                      },
                                      "applicationNo": {
                                        "type": "string",
                                        "description": "Application number.",
                                        "example": "US15/123456"
                                      },
                                      "applicationDate": {
                                        "type": "string",
                                        "description": "Application date.",
                                        "example": null
                                      },
                                      "applicants": {
                                        "type": "array",
                                        "description": "Applicants.",
                                        "example": []
                                      },
                                      "inventors": {
                                        "type": "array",
                                        "description": "Inventors.",
                                        "example": []
                                      },
                                      "assignees": {
                                        "type": "array",
                                        "description": "Assignees.",
                                        "example": []
                                      },
                                      "assigneeAddresses": {
                                        "type": "array",
                                        "description": "Assignee addresses.",
                                        "example": []
                                      },
                                      "ipcMain": {
                                        "type": "string",
                                        "description": "Main IPC classification.",
                                        "example": null
                                      },
                                      "ipcFurther": {
                                        "type": "array",
                                        "description": "IPC classifications.",
                                        "example": []
                                      },
                                      "cpcMain": {
                                        "type": "string",
                                        "description": "Main CPC classification.",
                                        "example": null
                                      },
                                      "cpcFurther": {
                                        "type": "array",
                                        "description": "Additional CPC classifications.",
                                        "example": []
                                      },
                                      "loc": {
                                        "type": "array",
                                        "description": "LOC classifications.",
                                        "example": []
                                      },
                                      "gbc": {
                                        "type": "array",
                                        "description": "GBC classifications.",
                                        "example": []
                                      },
                                      "priorityClaims": {
                                        "type": "array",
                                        "description": "Priority claims.",
                                        "example": []
                                      },
                                      "pctApplicationNo": {
                                        "type": "string",
                                        "description": "PCT application number.",
                                        "example": null
                                      },
                                      "pctFilingDate": {
                                        "type": "string",
                                        "description": "PCT filing date.",
                                        "example": null
                                      },
                                      "pctEntryDate": {
                                        "type": "string",
                                        "description": "PCT entry date.",
                                        "example": null
                                      },
                                      "citedPatents": {
                                        "type": "array",
                                        "description": "Cited patents.",
                                        "example": []
                                      },
                                      "citedNonPatents": {
                                        "type": "array",
                                        "description": "Cited non-patent literature.",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Provider rendering columns.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider render style.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Provider-reported token cost.",
                                  "example": 6000
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "allRecordsCount": 1,
                    "data": [
                      {
                        "patentId": "patent-id",
                        "title": "Wireless speaker system",
                        "abstractContent": "A wireless speaker system...",
                        "publicationNumber": "US10123456B2",
                        "applicationNo": "US15/123456",
                        "applicants": [],
                        "inventors": [],
                        "assignees": [],
                        "assigneeAddresses": [],
                        "ipcFurther": [],
                        "cpcFurther": [],
                        "loc": [],
                        "gbc": [],
                        "priorityClaims": [],
                        "citedPatents": [],
                        "citedNonPatents": []
                      }
                    ],
                    "columns": [],
                    "costToken": 6000
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-core-bibliography",
        "x-nexscope-mcp-tool-name": "nexscope_patent_core_bibliography",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-description-data-translation/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Description Data Translation",
        "description": "Retrieve translated patent description (specification) text from Nexscope. Triggered when users request patent specification translation, patent full text in other languages, translated patent full text, or want to view patent specifications in Chinese, English, or Japanese, patent specification translation, patent description translation, Nexscope, or patent translation. Also triggered when users provide a patent ID or publication number and request specification/description content in another language, or mention \"patent specification translation,\" \"description translation,\" \"translated full text,\" or similar intent.",
        "operationId": "runPatentDescriptionDataTranslation",
        "externalDocs": {
          "description": "Patent Description Data Translation documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-description-data-translation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.patent-description-data-translation.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "Patent ID. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "Publication (grant) number. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters",
                    "example": "CN115000000A"
                  },
                  "lang": {
                    "type": "string",
                    "description": "Translation language, supports en (English, default), cn (Chinese), jp (Japanese). Max length: 1000 characters",
                    "example": "en"
                  },
                  "replaceByRelated": {
                    "type": "integer",
                    "description": "Whether to substitute with a family patent's description when the description is unavailable: 1 Yes, 0 No (default 0)",
                    "example": 1
                  }
                },
                "example": {
                  "patentNumber": "CN115000000A",
                  "lang": "en",
                  "replaceByRelated": 1
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "CN115000000A",
                "lang": "en",
                "replaceByRelated": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Patent ID",
                                        "example": "example-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication (grant) number",
                                        "example": null
                                      },
                                      "description": {
                                        "type": "string",
                                        "description": "Translated description text",
                                        "example": null
                                      },
                                      "pnRelated": {
                                        "type": "string",
                                        "description": "Publication number of the substitute patent (only provided when family patent substitution is used)",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "example-id"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-description-data-translation",
        "x-nexscope-mcp-tool-name": "nexscope_patent_description_data_translation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-detailed-bibliography/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Detailed Bibliography",
        "description": "Query patent bibliographic (catalog) information from the Nexscope patent database by patent ID or publication number. Triggered when users mention patent bibliographic info queries, patent catalog information, patent applicant queries, patent inventor queries, patent classification codes, patent abstract retrieval, patent citation analysis, patent priority claims, patent application citations, patent examiner information, patent bibliographic data, inventor lookup, applicant lookup, patent classification, patent metadata, Nexscope, or patent citations. Even if the user does not explicitly mention \"bibliographic info,\" this skill should be triggered whenever their need involves querying detailed metadata for a specific patent by patent ID or publication number.",
        "operationId": "runPatentDetailedBibliography",
        "externalDocs": {
          "description": "Patent Detailed Bibliography documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-detailed-bibliography"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.patent-detailed-bibliography.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "Patent ID (at least one of patentId and patentNumber must be provided; if both are present, patentId takes priority). Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60,000 characters"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "Publication/grant number (at least one of patentId and patentNumber must be provided; if both are present, patentId takes priority). Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60,000 characters",
                    "example": "US11299876B2"
                  }
                },
                "example": {
                  "patentNumber": "US11299876B2"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US11299876B2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Bibliography data list (see data fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Patent ID",
                                        "example": "example-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication/grant number",
                                        "example": null
                                      },
                                      "inventionTitle": {
                                        "type": "array",
                                        "description": "Patent title language and name",
                                        "example": []
                                      },
                                      "abstracts": {
                                        "type": "array",
                                        "description": "Patent abstract",
                                        "example": []
                                      },
                                      "patentType": {
                                        "type": "string",
                                        "description": "Patent type. APPLICATION: invention application, PATENT: granted invention, UTILITY: utility model, DESIGN: design",
                                        "example": null
                                      },
                                      "applicants": {
                                        "type": "array",
                                        "description": "Original applicants",
                                        "example": []
                                      },
                                      "assignees": {
                                        "type": "array",
                                        "description": "Current applicants (patentees)",
                                        "example": []
                                      },
                                      "inventors": {
                                        "type": "array",
                                        "description": "Inventors",
                                        "example": []
                                      },
                                      "agents": {
                                        "type": "array",
                                        "description": "Patent applicants",
                                        "example": []
                                      },
                                      "agency": {
                                        "type": "array",
                                        "description": "Application agency",
                                        "example": []
                                      },
                                      "examiners": {
                                        "type": "array",
                                        "description": "Examiner information",
                                        "example": []
                                      },
                                      "priorityClaims": {
                                        "type": "array",
                                        "description": "Priority claims",
                                        "example": []
                                      },
                                      "applicationReference": {
                                        "type": "object",
                                        "description": "Application filing reference data",
                                        "example": {}
                                      },
                                      "publicationReference": {
                                        "type": "object",
                                        "description": "Publication reference data",
                                        "example": {}
                                      },
                                      "datesOfPublicAvailability": {
                                        "type": "object",
                                        "description": "Public availability dates",
                                        "example": {}
                                      },
                                      "classificationIpcr": {
                                        "type": "object",
                                        "description": "IPC classification",
                                        "example": {}
                                      },
                                      "classificationCpc": {
                                        "type": "object",
                                        "description": "CPC classification",
                                        "example": {}
                                      },
                                      "classificationUpc": {
                                        "type": "object",
                                        "description": "US patent classification",
                                        "example": {}
                                      },
                                      "classificationLoc": {
                                        "type": "array",
                                        "description": "LOC classification",
                                        "example": []
                                      },
                                      "classificationFi": {
                                        "type": "array",
                                        "description": "FI classification",
                                        "example": []
                                      },
                                      "classificationFterm": {
                                        "type": "array",
                                        "description": "F-term classification",
                                        "example": []
                                      },
                                      "classificationGbc": {
                                        "type": "object",
                                        "description": "GBC classification",
                                        "example": {}
                                      },
                                      "referenceCitedPatents": {
                                        "type": "array",
                                        "description": "Cited patent documents",
                                        "example": []
                                      },
                                      "referenceCitedOthers": {
                                        "type": "array",
                                        "description": "Cited non-patent literature",
                                        "example": []
                                      },
                                      "relatedDocuments": {
                                        "type": "array",
                                        "description": "Divisional/continuation application information",
                                        "example": []
                                      },
                                      "pctOrRegionalFilingData": {
                                        "type": "object",
                                        "description": "PCT or regional phase filing data",
                                        "example": {}
                                      },
                                      "pctOrRegionalPublishingData": {
                                        "type": "object",
                                        "description": "PCT or regional phase publication data",
                                        "example": {}
                                      },
                                      "exdt": {
                                        "type": "integer",
                                        "description": "Nexscope estimated patent expiration date",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Columns for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "example-id",
                        "inventionTitle": [],
                        "abstracts": [],
                        "applicants": [],
                        "assignees": [],
                        "inventors": [],
                        "agents": [],
                        "agency": [],
                        "examiners": [],
                        "priorityClaims": [],
                        "applicationReference": {},
                        "publicationReference": {},
                        "datesOfPublicAvailability": {},
                        "classificationIpcr": {},
                        "classificationCpc": {},
                        "classificationUpc": {},
                        "classificationLoc": [],
                        "classificationFi": [],
                        "classificationFterm": [],
                        "classificationGbc": {},
                        "referenceCitedPatents": [],
                        "referenceCitedOthers": [],
                        "relatedDocuments": [],
                        "pctOrRegionalFilingData": {},
                        "pctOrRegionalPublishingData": {},
                        "exdt": 1
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-detailed-bibliography",
        "x-nexscope-mcp-tool-name": "nexscope_patent_detailed_bibliography",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-family-data/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Family Data",
        "description": "Returns patent family identifiers and members for up to 100 patents.",
        "operationId": "runPatentFamilyData",
        "externalDocs": {
          "description": "Patent Family Data documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-family-data"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Provide patentId or patentNumber. A request may contain at most 100 comma-separated patents.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "One or up to 100 comma-separated Nexscope patent IDs. Takes precedence when both identifiers are provided.",
                    "example": "patent-id"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "One or up to 100 comma-separated publication or grant numbers.",
                    "example": "US10123456B2"
                  }
                },
                "example": {
                  "patentNumber": "US10123456B2"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US10123456B2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of returned records.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent family records.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Queried patent ID.",
                                        "example": "patent-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication number.",
                                        "example": "US10123456B2"
                                      },
                                      "simpleFamilyId": {
                                        "type": "integer",
                                        "description": "Simple family identifier.",
                                        "example": 1
                                      },
                                      "simpleFamily": {
                                        "type": "array",
                                        "description": "Simple family members.",
                                        "example": []
                                      },
                                      "inpadocFamilyId": {
                                        "type": "integer",
                                        "description": "INPADOC family identifier.",
                                        "example": 1
                                      },
                                      "inpadocFamily": {
                                        "type": "array",
                                        "description": "INPADOC family members.",
                                        "example": []
                                      },
                                      "patsnapFamilyId": {
                                        "type": "integer",
                                        "description": "Nexscope family identifier.",
                                        "example": 1
                                      },
                                      "patsnapFamily": {
                                        "type": "array",
                                        "description": "Nexscope family members.",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Provider rendering columns.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider rendering style.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Provider-reported token cost.",
                                  "example": 6000
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "patent-id",
                        "pn": "US10123456B2",
                        "simpleFamilyId": 1,
                        "simpleFamily": [],
                        "inpadocFamilyId": 1,
                        "inpadocFamily": [],
                        "patsnapFamilyId": 1,
                        "patsnapFamily": []
                      }
                    ],
                    "columns": [],
                    "costToken": 6000
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-family-data",
        "x-nexscope-mcp-tool-name": "nexscope_patent_family_data",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-fulltext-images/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Fulltext Images",
        "description": "Retrieve fulltext images (drawings, diagrams, charts) from patent documents by patent ID or publication number. Triggered when users ask about patent images, patent drawings, patent diagrams, patent illustrations, fulltext drawings, patent charts, patent technical drawings, or want to view/download embedded images in patent documents, patent fulltext drawings, patent diagrams, technical drawings, patent images, or Nexscope. Even if the user does not explicitly mention \"fulltext drawings,\" this skill should be triggered whenever their need involves obtaining visual content (drawings, diagrams, charts) from specific patents.",
        "operationId": "runPatentFulltextImages",
        "externalDocs": {
          "description": "Patent Fulltext Images documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-fulltext-images"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.patent-fulltext-images.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "Patent ID"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "Publication (grant) number",
                    "example": "US11299876B2"
                  },
                  "limit": {
                    "type": "string",
                    "description": "Total number of images to return, max 100, default \"100\"",
                    "example": "10"
                  },
                  "offset": {
                    "type": "string",
                    "description": "Offset",
                    "example": "0"
                  }
                },
                "example": {
                  "patentNumber": "US11299876B2",
                  "limit": "10",
                  "offset": "0"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US11299876B2",
                "limit": "10",
                "offset": "0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Patent ID",
                                        "example": "example-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication (grant) number",
                                        "example": null
                                      },
                                      "fulltextImagePath": {
                                        "type": "string",
                                        "description": "Image path",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "imageType": {
                                        "type": "string",
                                        "description": "Image type",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Columns for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "example-id",
                        "fulltextImagePath": "https://example.com/image.jpg"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-fulltext-images",
        "x-nexscope-mcp-tool-name": "nexscope_patent_fulltext_images",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-legal-status-data/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Legal Status Data",
        "description": "Query patent legal status information from the Nexscope (Nexscope) database. Triggered when users mention patent legal status, patent validity check, patent status query, patent event history, simple legal status, legal events such as transfer, license, pledge, opposition, litigation, re-examination, patent legal status, patent validity, patent events, transfer/license/pledge, Nexscope, or patent status lookup. Also triggered when users ask whether a patent is active, inactive, pending, expired, granted, withdrawn, or revoked, or want to look up legal status by patent ID or publication number.",
        "operationId": "runPatentLegalStatusData",
        "externalDocs": {
          "description": "Patent Legal Status Data documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-legal-status-data"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.patent-legal-status-data.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "Patent ID. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters."
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "Publication (grant) number. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters.",
                    "example": "US11299876B2"
                  }
                },
                "example": {
                  "patentNumber": "US11299876B2"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US11299876B2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent legal status list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Patent ID",
                                        "example": "example-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication (grant) number",
                                        "example": null
                                      },
                                      "simpleLegalStatus": {
                                        "type": "array",
                                        "description": "Simple legal status. Options: Inactive, Active, Pending, Undetermined, PCT designated period, PCT designated expiration",
                                        "example": []
                                      },
                                      "legalStatus": {
                                        "type": "array",
                                        "description": "Legal status. Options: Published, Examining, Granted, Double, Abandoned-Undetermined, Abandoned-Voluntarily, Abandoned-Deemed, Withdrawn-Undetermined, Withdrawn-Voluntarily, Withdrawn-Deemed, Rejected, Revoked, Expired, Non-Payment, Restoration, Ceased, P-Revoked, Discontinuation, PCT published, PCT entering(designated period), PCT entering(designated expiration), PCT unentered",
                                        "example": []
                                      },
                                      "eventStatus": {
                                        "type": "array",
                                        "description": "Legal events. Options: Transfer, License, Pledge, Trust, Opposition, Re-examination, Customs, Litigation, Preservation, Invalid-procedure, Oral-procedure, Declassification, Double application",
                                        "example": []
                                      },
                                      "legalDate": {
                                        "type": "integer",
                                        "description": "Legal status update date (timestamp)",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "example-id",
                        "simpleLegalStatus": [],
                        "legalStatus": [],
                        "eventStatus": [],
                        "legalDate": 1
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-legal-status-data",
        "x-nexscope-mcp-tool-name": "nexscope_patent_legal_status_data",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-references/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent References",
        "description": "Returns forward citation details for up to 100 patents.",
        "operationId": "runPatentReferences",
        "externalDocs": {
          "description": "Patent References documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-references"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Provide patentId or patentNumber. A request may contain at most 100 comma-separated patents.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "One or up to 100 comma-separated Nexscope patent IDs. Takes precedence when both identifiers are provided.",
                    "example": "patent-id"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "One or up to 100 comma-separated publication or grant numbers.",
                    "example": "US10123456B2"
                  }
                },
                "example": {
                  "patentNumber": "US10123456B2"
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "US10123456B2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of returned records.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent reference records.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Queried patent ID.",
                                        "example": "patent-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication number.",
                                        "example": "US10123456B2"
                                      },
                                      "citedPatents": {
                                        "type": "array",
                                        "description": "Cited patent references.",
                                        "example": []
                                      },
                                      "citedOthers": {
                                        "type": "array",
                                        "description": "Cited non-patent literature.",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Provider rendering columns.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider rendering style.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Provider-reported token cost.",
                                  "example": 6000
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "patent-id",
                        "pn": "US10123456B2",
                        "citedPatents": [],
                        "citedOthers": []
                      }
                    ],
                    "columns": [],
                    "costToken": 6000
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-references",
        "x-nexscope-mcp-tool-name": "nexscope_patent_references",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-search/run": {
      "post": {
        "tags": [
          "Patent Intelligence"
        ],
        "summary": "Patent Search",
        "description": "Searches Nexscope patents and returns matching publications and the full hit count.",
        "operationId": "runPatentSearch",
        "externalDocs": {
          "description": "Patent Search documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Search parameters for the patent provider.",
                "properties": {
                  "queryText": {
                    "type": "string",
                    "description": "Optional patent Analytics query expression forwarded as documented by the provider.",
                    "example": "TI=(wireless speaker)"
                  },
                  "pageNum": {
                    "type": "integer",
                    "description": "Page number.",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page.",
                    "example": 20
                  }
                },
                "example": {
                  "pageNum": 1,
                  "queryText": "TI=(wireless speaker)",
                  "pageSize": 20
                },
                "additionalProperties": true
              },
              "example": {
                "pageNum": 1,
                "queryText": "TI=(wireless speaker)",
                "pageSize": 20
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records returned in this response.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "allRecordsCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matching records.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Matching patent records.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Nexscope patent identifier.",
                                        "example": "123456789"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication number.",
                                        "example": "CN123456789A"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Patent title.",
                                        "example": "Virtual reality display"
                                      },
                                      "apdt": {
                                        "type": "integer",
                                        "description": "Application date in YYYYMMDD form.",
                                        "example": 20200101
                                      },
                                      "pbdt": {
                                        "type": "integer",
                                        "description": "Publication date in YYYYMMDD form.",
                                        "example": 20210101
                                      },
                                      "apno": {
                                        "type": "string",
                                        "description": "Application number.",
                                        "example": "CN202010000001"
                                      },
                                      "authority": {
                                        "type": "string",
                                        "description": "Patent authority code.",
                                        "example": "CN"
                                      },
                                      "inventor": {
                                        "type": "string",
                                        "description": "Inventors separated by |.",
                                        "example": "A | B"
                                      },
                                      "originalAssignee": {
                                        "type": "string",
                                        "description": "Original assignees separated by |.",
                                        "example": "Company A"
                                      },
                                      "currentAssignee": {
                                        "type": "string",
                                        "description": "Current assignees separated by |.",
                                        "example": "Company B"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendering column metadata.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendering style.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "allRecordsCount": 1,
                    "data": [
                      {
                        "patentId": "123456789",
                        "pn": "CN123456789A",
                        "title": "Virtual reality display",
                        "apdt": 20200101,
                        "pbdt": 20210101,
                        "apno": "CN202010000001",
                        "authority": "CN",
                        "inventor": "A | B",
                        "originalAssignee": "Company A",
                        "currentAssignee": "Company B"
                      }
                    ],
                    "columns": []
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-search",
        "x-nexscope-mcp-tool-name": "nexscope_patent_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/patent-title-abstract-translation/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Patent Title Abstract Translation",
        "description": "Retrieve translated patent titles and abstracts from the Nexscope (Nexscope) patent database. Triggered when users request patent abstract translation, patent title translation, translated patent abstracts, patent content in other languages, patent abstracts in Chinese/English/Japanese, or need to look up abstracts and titles of specific patents by patent ID or publication number, patent abstract translation, patent title translation, Nexscope, patent translation, or abstract lookup. Also triggered when users mention Nexscope, Nexscope, or patent abstract queries, even if \"translation\" is not explicitly mentioned.",
        "operationId": "runPatentTitleAbstractTranslation",
        "externalDocs": {
          "description": "Patent Title Abstract Translation documentation",
          "url": "https://www.nexscope.ai/api-docs/patent-title-abstract-translation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.patent-title-abstract-translation.",
                "properties": {
                  "patentId": {
                    "type": "string",
                    "description": "Nexscope internal patent ID. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60,000 characters"
                  },
                  "patentNumber": {
                    "type": "string",
                    "description": "Publication (grant) number. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60,000 characters",
                    "example": "CN115000000A"
                  },
                  "replaceByRelated": {
                    "type": "integer",
                    "description": "Whether to substitute with a family patent's abstract when the abstract is unavailable: 1 Yes, 0 No. Default 0",
                    "example": 1
                  },
                  "lang": {
                    "type": "string",
                    "description": "Target translation language. Options: en (English, default), cn (Chinese), jp (Japanese). Max length: 1,000 characters",
                    "example": "en"
                  }
                },
                "example": {
                  "patentNumber": "CN115000000A",
                  "lang": "en",
                  "replaceByRelated": 1
                },
                "additionalProperties": true
              },
              "example": {
                "patentNumber": "CN115000000A",
                "lang": "en",
                "replaceByRelated": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of patent records returned",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Nexscope internal patent ID",
                                        "example": "example-id"
                                      },
                                      "pn": {
                                        "type": "string",
                                        "description": "Publication (grant) number",
                                        "example": null
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Title translation",
                                        "example": null
                                      },
                                      "abstractText": {
                                        "type": "string",
                                        "description": "Abstract translation",
                                        "example": null
                                      },
                                      "pnRelated": {
                                        "type": "string",
                                        "description": "Publication number of the substitute patent (only provided when family patent substitution is used)",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentId": "example-id"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "patent-title-abstract-translation",
        "x-nexscope-mcp-tool-name": "nexscope_patent_title_abstract_translation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/product-description-generator/run": {
      "post": {
        "tags": [
          "Ecommerce Content Generation"
        ],
        "summary": "Product Description Generator",
        "description": "Creates a text-generation task from product copy instructions and image URLs, or queries a known task ID.",
        "operationId": "runProductDescriptionGenerator",
        "externalDocs": {
          "description": "Product Description Generator documentation",
          "url": "https://www.nexscope.ai/api-docs/product-description-generator"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Use operation=query with the provider taskId returned by create. Query is sent to the skill's /aigc/textTaskQuery endpoint; the system task-result endpoint is not used.",
                "properties": {
                  "operation": {
                    "type": "string",
                    "description": "create (default) or query.",
                    "example": "create"
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Product-copy generation instruction; required by create.",
                    "example": "Write a product description for a wireless speaker."
                  },
                  "imageUrls": {
                    "type": "array",
                    "items": {},
                    "description": "Public image URLs used as visual context; required by create and may be empty.",
                    "example": []
                  },
                  "thinkingLevel": {
                    "type": "string",
                    "description": "Reasoning level required by create.",
                    "example": "minimal"
                  },
                  "model": {
                    "type": "string",
                    "description": "Optional supported text-generation model.",
                    "example": "GEM_3_FLASH"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "Optional provider member identifier used by create and query.",
                    "example": "member-id"
                  },
                  "taskId": {
                    "type": "string",
                    "description": "Provider task ID returned by create; required by operation=query.",
                    "example": "123456789"
                  }
                },
                "example": {
                  "operation": "create",
                  "thinkingLevel": "minimal",
                  "prompt": "Write a product description for a wireless speaker.",
                  "imageUrls": []
                },
                "additionalProperties": true
              },
              "example": {
                "operation": "create",
                "thinkingLevel": "minimal",
                "prompt": "Write a product description for a wireless speaker.",
                "imageUrls": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "taskId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Asynchronous generation task ID.",
                                  "example": "123456789"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Task status such as PROCESSING, SUCCESS, or FAILED.",
                                  "example": "PROCESSING"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "content": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Generated product copy when the task succeeds.",
                                  "example": "Example product description."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "promptTokens": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Input token count when the task succeeds.",
                                  "example": 120
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "completionTokens": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Output token count when the task succeeds.",
                                  "example": 350
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalTokens": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total token count when the task succeeds.",
                                  "example": 470
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Provider-reported token cost.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "123456789",
                    "status": "PROCESSING",
                    "content": "Example product description.",
                    "promptTokens": 120,
                    "completionTokens": 350,
                    "totalTokens": 470,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": "Generation failed.",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "product-description-generator",
        "x-nexscope-mcp-tool-name": "nexscope_product_description_generator",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ruiguan-copyright-detection/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Ruiguan Copyright Detection",
        "description": "Detect image copyright infringement risks by comparing against a database of registered copyrighted works with similarity scoring, TRO litigation history, and radar-based infringement assessment. Triggered when users mention copyright detection, image infringement check, copyright risk analysis, TRO risk, copyright similarity search, rights owner lookup, or copyright compliance verification. Even if the user does not explicitly say \"copyright,\" this skill should be triggered whenever the need involves checking whether an image may infringe registered copyright works.",
        "operationId": "runRuiguanCopyrightDetection",
        "externalDocs": {
          "description": "Ruiguan Copyright Detection documentation",
          "url": "https://www.nexscope.ai/api-docs/ruiguan-copyright-detection"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ruiguan-copyright-detection.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "URL of the copyrighted image to inspect (maximum 1,000 characters)",
                    "example": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
                  },
                  "topNumber": {
                    "type": "integer",
                    "description": "Maximum number of matches to return (default 100, minimum 10, maximum 200)",
                    "example": 10
                  },
                  "enableRadar": {
                    "type": "boolean",
                    "description": "Whether to enable radar detection (default true)",
                    "example": false
                  }
                },
                "required": [
                  "imageUrl",
                  "topNumber",
                  "enableRadar"
                ],
                "example": {
                  "topNumber": 10,
                  "enableRadar": false,
                  "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
                },
                "additionalProperties": true
              },
              "example": {
                "topNumber": 10,
                "enableRadar": false,
                "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Detection results; see the fields below",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "path": {
                                        "type": "string",
                                        "description": "Path to the copyrighted artwork",
                                        "example": null
                                      },
                                      "pathThumb": {
                                        "type": "string",
                                        "description": "Thumbnail path for the copyrighted artwork",
                                        "example": null
                                      },
                                      "similarity": {
                                        "type": "string",
                                        "description": "Similarity score",
                                        "example": null
                                      },
                                      "subRadarResult": {
                                        "type": "integer",
                                        "description": "Radar result: 1 means infringement, 0 means no infringement, and null means radar detection was not performed",
                                        "example": 1
                                      },
                                      "copyrightUrl": {
                                        "type": "string",
                                        "description": "Source URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "copyrightCode": {
                                        "type": "string",
                                        "description": "Copyright identifier",
                                        "example": null
                                      },
                                      "rightsOwner": {
                                        "type": "string",
                                        "description": "Rights owner",
                                        "example": null
                                      },
                                      "link": {
                                        "type": "string",
                                        "description": "Official copyright website URL",
                                        "example": null
                                      },
                                      "troCase": {
                                        "type": "boolean",
                                        "description": "Whether the copyright has a history of TRO enforcement",
                                        "example": false
                                      },
                                      "troHolder": {
                                        "type": "boolean",
                                        "description": "Whether the copyright belongs to a TRO rights holder",
                                        "example": false
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "detectId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Detection ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions used for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendering style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "subRadarResult": 1,
                        "copyrightUrl": "https://example.com/image.jpg",
                        "troCase": false,
                        "troHolder": false
                      }
                    ],
                    "detectId": "example-id",
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ruiguan-copyright-detection",
        "x-nexscope-mcp-tool-name": "nexscope_ruiguan_copyright_detection",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ruiguan-detection-patent-design/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Ruiguan Detection Patent Design",
        "description": "Detect design patent infringement risks by comparing a product image against a global design patent database across 25+ jurisdictions. Triggered when users mention design patent detection, patent infringement check, patent risk analysis, TRO case lookup, design patent search, product design patent screen, or visual patent similarity. Even if the user does not explicitly say \"design patent,\" this skill should be triggered whenever the need involves checking whether a product image may infringe existing design patents.",
        "operationId": "runRuiguanDetectionPatentDesign",
        "externalDocs": {
          "description": "Ruiguan Detection Patent Design documentation",
          "url": "https://www.nexscope.ai/api-docs/ruiguan-detection-patent-design"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ruiguan-detection-patent-design.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Product image URL used for comparison with the patent database (maximum 1,000 characters)",
                    "example": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
                  },
                  "queryMode": {
                    "type": "string",
                    "description": "Search mode: physical for product-photo search, line for line-drawing search, or hybrid for combined search. Maximum 1,000 characters",
                    "example": "physical"
                  },
                  "topNumber": {
                    "type": "integer",
                    "description": "Number of patents to return (maximum 100)",
                    "example": 10
                  },
                  "regions": {
                    "type": "string",
                    "description": "Country or region codes where the product is sold, separated by commas, for example US,EU,CN. Supported values: US, EU, CN, JP, KR, DE, GB, FR, IT, AU, CA, BR, MX, IN, TH, SE, CH, IE, IL, DK, NZ, AT, BX, FI, and WO. Maximum 1,000 characters",
                    "example": "US"
                  },
                  "productTitle": {
                    "type": "string",
                    "description": "Product title used to provide additional search context (maximum 1,000 characters)",
                    "example": "Magnetic phone case"
                  },
                  "productDescription": {
                    "type": "string",
                    "description": "Product description used to provide additional search context (maximum 1,000 characters)",
                    "example": "A protective smartphone case with a magnetic ring stand and shockproof corners."
                  },
                  "patentStatus": {
                    "type": "string",
                    "description": "Patent-validity filter: 1 for active patents, 0 for inactive patents, or 1,0 for all patents. Maximum 1,000 characters",
                    "example": "1,0"
                  },
                  "enableRadar": {
                    "type": "boolean",
                    "description": "Whether to enable AI radar analysis for potential infringement",
                    "example": false
                  },
                  "topLoc": {
                    "type": "string",
                    "description": "Top-level LOC classes to search, for example 06,07. Pattern: ^(0[1-9]\\"
                  },
                  "sourceLanguage": {
                    "type": "string",
                    "description": "Source-language code used to translate content into English, for example zh-CN. Leave empty when the text is already English. Maximum 1,000 characters"
                  }
                },
                "required": [
                  "imageUrl",
                  "queryMode",
                  "topNumber"
                ],
                "example": {
                  "regions": "US",
                  "topNumber": 10,
                  "productDescription": "A protective smartphone case with a magnetic ring stand and shockproof corners.",
                  "queryMode": "physical",
                  "patentStatus": "1,0",
                  "productTitle": "Magnetic phone case",
                  "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
                  "enableRadar": false
                },
                "additionalProperties": true
              },
              "example": {
                "regions": "US",
                "topNumber": 10,
                "productDescription": "A protective smartphone case with a magnetic ring stand and shockproof corners.",
                "queryMode": "physical",
                "patentStatus": "1,0",
                "productTitle": "Magnetic phone case",
                "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
                "enableRadar": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of patent records returned",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent records; see the patent fields below",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "applicationNumber": {
                                        "type": "string",
                                        "description": "Patent application number",
                                        "example": null
                                      },
                                      "publicationNumber": {
                                        "type": "string",
                                        "description": "Patent publication number",
                                        "example": null
                                      },
                                      "patentProd": {
                                        "type": "string",
                                        "description": "Patent title in English",
                                        "example": null
                                      },
                                      "patentProdCn": {
                                        "type": "string",
                                        "description": "Patent title in Chinese",
                                        "example": null
                                      },
                                      "similarity": {
                                        "type": "string",
                                        "description": "Similarity between the patent and product image (0-1)",
                                        "example": null
                                      },
                                      "patentImageUrl": {
                                        "type": "string",
                                        "description": "URL of the patent drawing most similar to the product image",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "images": {
                                        "type": "array",
                                        "description": "Patent image URLs",
                                        "example": []
                                      },
                                      "abstracts": {
                                        "type": "string",
                                        "description": "Patent abstract",
                                        "example": null
                                      },
                                      "specification": {
                                        "type": "string",
                                        "description": "Patent specification",
                                        "example": null
                                      },
                                      "inventors": {
                                        "type": "array",
                                        "description": "Inventors",
                                        "example": []
                                      },
                                      "applicants": {
                                        "type": "array",
                                        "description": "Applicants",
                                        "example": []
                                      },
                                      "applicantAddresses": {
                                        "type": "array",
                                        "description": "Applicant addresses",
                                        "example": []
                                      },
                                      "troCase": {
                                        "type": "boolean",
                                        "description": "Whether the patent has a history of TRO enforcement",
                                        "example": false
                                      },
                                      "troHolder": {
                                        "type": "boolean",
                                        "description": "Whether the patent belongs to a TRO rights holder",
                                        "example": false
                                      },
                                      "radarResult": {
                                        "type": "object",
                                        "description": "AI radar analysis result",
                                        "example": {},
                                        "properties": {
                                          "same": {
                                            "type": "boolean",
                                            "description": "Whether infringement is suspected",
                                            "example": false
                                          },
                                          "exp": {
                                            "type": "string",
                                            "description": "Radar decision explanation",
                                            "example": null
                                          }
                                        }
                                      },
                                      "patentLoc": {
                                        "type": "string",
                                        "description": "LOC classifications for the patent, separated by commas",
                                        "example": null
                                      },
                                      "locOneInfo": {
                                        "type": "string",
                                        "description": "Top-level LOC details",
                                        "example": null
                                      },
                                      "locTwoInfo": {
                                        "type": "string",
                                        "description": "Second-level LOC details",
                                        "example": null
                                      },
                                      "patentValidity": {
                                        "type": "string",
                                        "description": "Patent validity",
                                        "example": null
                                      },
                                      "applicationDate": {
                                        "type": "string",
                                        "description": "Patent application date",
                                        "example": "2026-01-01"
                                      },
                                      "publicationDate": {
                                        "type": "string",
                                        "description": "Patent publication date",
                                        "example": "2026-01-01"
                                      },
                                      "grantDate": {
                                        "type": "string",
                                        "description": "Patent grant date",
                                        "example": "2026-01-01"
                                      },
                                      "estimatedDueDate": {
                                        "type": "string",
                                        "description": "Estimated expiration date",
                                        "example": "2026-01-01"
                                      },
                                      "registrationOfficeCode": {
                                        "type": "string",
                                        "description": "Patent registration office",
                                        "example": null
                                      },
                                      "patentFamily": {
                                        "type": "array",
                                        "description": "Patent family",
                                        "example": []
                                      },
                                      "globalPatentId": {
                                        "type": "string",
                                        "description": "Global patent ID",
                                        "example": "example-id"
                                      },
                                      "globalImageId": {
                                        "type": "string",
                                        "description": "Patent image ID",
                                        "example": "example-id"
                                      },
                                      "isSketchText": {
                                        "type": "string",
                                        "description": "Whether the image is a line drawing",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions used for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendering style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "patentImageUrl": "https://example.com/image.jpg",
                        "images": [],
                        "inventors": [],
                        "applicants": [],
                        "applicantAddresses": [],
                        "troCase": false,
                        "troHolder": false,
                        "radarResult": {
                          "same": false
                        },
                        "applicationDate": "2026-01-01",
                        "publicationDate": "2026-01-01",
                        "grantDate": "2026-01-01",
                        "estimatedDueDate": "2026-01-01",
                        "patentFamily": [],
                        "globalPatentId": "example-id",
                        "globalImageId": "example-id"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ruiguan-detection-patent-design",
        "x-nexscope-mcp-tool-name": "nexscope_ruiguan_detection_patent_design",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ruiguan-gun-parts-search/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Ruiguan Gun Parts Search",
        "description": "Check product images against a database of policy-violating items using visual similarity matching. Triggered when users mention policy compliance check, product image compliance review, violation detection, prohibited product screening, image-based compliance audit, pre-listing risk screening, or product image risk check. Even if the user does not explicitly say \"compliance,\" this skill should be triggered whenever the need involves comparing product images against a violation database.",
        "operationId": "runRuiguanGunPartsSearch",
        "externalDocs": {
          "description": "Ruiguan Gun Parts Search documentation",
          "url": "https://www.nexscope.ai/api-docs/ruiguan-gun-parts-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ruiguan-gun-parts-search.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "URL of the product image to inspect (maximum 1,000 characters)",
                    "example": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
                  }
                },
                "required": [
                  "imageUrl"
                ],
                "example": {
                  "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Detected policy-violating products; see the fields below",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "pdImgOssUrl": {
                                        "type": "string",
                                        "description": "Image URL of the matched policy-violating product",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "cosine": {
                                        "type": "number",
                                        "description": "Similarity between the inspected product and the policy-violating product",
                                        "example": 1
                                      },
                                      "pdTitle": {
                                        "type": "string",
                                        "description": "Title of the matched policy-violating product",
                                        "example": null
                                      },
                                      "pdTitleCHNCensored": {
                                        "type": "string",
                                        "description": "Chinese title of the matched policy-violating product",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "detectId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Detection record ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions used for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendering style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "pdImgOssUrl": "https://example.com/image.jpg",
                        "cosine": 1
                      }
                    ],
                    "detectId": "example-id",
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ruiguan-gun-parts-search",
        "x-nexscope-mcp-tool-name": "nexscope_ruiguan_gun_parts_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ruiguan-trademark-graphic-detection/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Ruiguan Trademark Graphic Detection",
        "description": "Detect graphic trademarks in product images by comparing against registered trademark databases across 15 major trademark offices using YOLO-based object detection and visual similarity. Triggered when users mention graphic trademark detection, logo infringement check, trademark similarity analysis, image trademark risk assessment, product image trademark screening, or logo detection. Even if the user does not explicitly say \"trademark detection,\" this skill should be triggered whenever the need involves comparing a product image against registered graphic trademarks or assessing trademark infringement risk.",
        "operationId": "runRuiguanTrademarkGraphicDetection",
        "externalDocs": {
          "description": "Ruiguan Trademark Graphic Detection documentation",
          "url": "https://www.nexscope.ai/api-docs/ruiguan-trademark-graphic-detection"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.ruiguan-trademark-graphic-detection.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Product image URL or Base64-encoded image data (maximum 1,000 characters)",
                    "example": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
                  },
                  "topNumber": {
                    "type": "integer",
                    "description": "Maximum number of YOLO bounding boxes to return (default 5, maximum 100). The actual result count may be lower",
                    "example": 1
                  },
                  "productTitle": {
                    "type": "string",
                    "description": "Product title used for context-aware detection (maximum 1,000 characters)"
                  },
                  "trademarkName": {
                    "type": "string",
                    "description": "Possible graphic-logo name used to narrow the search (maximum 1,000 characters)"
                  },
                  "regions": {
                    "type": "string",
                    "description": "Comma-separated country or region codes to inspect. Defaults to all regions. Supported values: US (United States), WO (WIPO), ES (Spain), GB (United Kingdom), DE (Germany), IT (Italy), CA (Canada), MX (Mexico), EM (European Union), AU (Australia), FR (France), JP (Japan), TR (Turkey), BX (Benelux), and CN (China)",
                    "example": "US"
                  },
                  "enableLocalizing": {
                    "type": "boolean",
                    "description": "Whether to enable image cropping (default false)",
                    "example": false
                  },
                  "enableRadar": {
                    "type": "boolean",
                    "description": "Whether to enable radar monitoring (default true)",
                    "example": false
                  }
                },
                "required": [
                  "imageUrl",
                  "topNumber"
                ],
                "example": {
                  "enableRadar": false,
                  "enableLocalizing": false,
                  "topNumber": 10,
                  "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
                  "regions": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "enableRadar": false,
                "enableLocalizing": false,
                "topNumber": 10,
                "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
                "regions": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "boundingBoxCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of detection results",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Detection results; see the fields below",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "radarResult": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "description": "Radar detection result",
                                            "example": null
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "image": {
                                        "type": "string",
                                        "description": "URL of the matched trademark image",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "boundingBox": {
                                        "type": "string",
                                        "description": "Comma-separated YOLO coordinates",
                                        "example": null
                                      },
                                      "subRadarResult": {
                                        "type": "string",
                                        "description": "Sub-radar detection result",
                                        "example": null
                                      },
                                      "applicationNumber": {
                                        "type": "string",
                                        "description": "Application number",
                                        "example": null
                                      },
                                      "niceClassName": {
                                        "type": "string",
                                        "description": "Comma-separated Nice Classification names",
                                        "example": null
                                      },
                                      "applicantName": {
                                        "type": "string",
                                        "description": "Comma-separated rights-holder names",
                                        "example": null
                                      },
                                      "tradeMarkStatus": {
                                        "type": "string",
                                        "description": "Trademark status. Values: \"DEL\", \"ended\", \"registered\", \"act\", \"pend\", \"filed\", or an empty string",
                                        "example": null
                                      },
                                      "niceClass": {
                                        "type": "array",
                                        "description": "Nice Classification details",
                                        "example": []
                                      },
                                      "similarity": {
                                        "type": "number",
                                        "description": "Similarity score from 0 to 1; higher values indicate greater similarity",
                                        "example": 1
                                      },
                                      "registrationNumber": {
                                        "type": "string",
                                        "description": "Registration number",
                                        "example": null
                                      },
                                      "registrationOfficeCode": {
                                        "type": "string",
                                        "description": "Trademark registration office",
                                        "example": null
                                      },
                                      "registrationDate": {
                                        "type": "string",
                                        "description": "Registration date",
                                        "example": "2026-01-01"
                                      },
                                      "bid": {
                                        "type": "string",
                                        "description": "Logo identifier",
                                        "example": "example-id"
                                      },
                                      "trademarkName": {
                                        "type": "string",
                                        "description": "Text trademark name found in the image",
                                        "example": null
                                      },
                                      "applicationDate": {
                                        "type": "string",
                                        "description": "Application date",
                                        "example": "2026-01-01"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "detectId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Detection ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions used for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendering style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "boundingBoxCount": 1,
                    "total": 1,
                    "data": [
                      {
                        "image": "https://example.com/image.jpg",
                        "niceClass": [],
                        "similarity": 1,
                        "registrationDate": "2026-01-01",
                        "bid": "example-id",
                        "applicationDate": "2026-01-01"
                      }
                    ],
                    "detectId": "example-id",
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ruiguan-trademark-graphic-detection",
        "x-nexscope-mcp-tool-name": "nexscope_ruiguan_trademark_graphic_detection",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/reverse-product-image-search/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Reverse Product Image Search",
        "description": "Runs the server-side image-search and enrichment workflow without exposing local file paths or intermediate artifacts.",
        "operationId": "runReverseProductImageSearch",
        "externalDocs": {
          "description": "Reverse Product Image Search documentation",
          "url": "https://www.nexscope.ai/api-docs/reverse-product-image-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "The backend manages intermediate workflow data; do not send local file paths.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Publicly accessible product image URL.",
                    "example": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
                  },
                  "amazonDomain": {
                    "type": "string",
                    "description": "Amazon marketplace domain.",
                    "example": "amazon.com"
                  },
                  "topN": {
                    "type": "integer",
                    "description": "Maximum number of ranked matches to return after enrichment.",
                    "example": 20
                  },
                  "sort": {
                    "type": "string",
                    "description": "Optional provider sort mode.",
                    "example": "rating-desc-rank"
                  }
                },
                "required": [
                  "imageUrl",
                  "amazonDomain"
                ],
                "example": {
                  "topN": 20,
                  "amazonDomain": "amazon.com",
                  "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
                },
                "additionalProperties": true
              },
              "example": {
                "topN": 20,
                "amazonDomain": "amazon.com",
                "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "query": {
                              "type": "object",
                              "description": "Normalized image-search query.",
                              "example": {}
                            },
                            "matches": {
                              "type": "array",
                              "description": "Visually similar Amazon products, optionally enriched with marketplace metrics.",
                              "example": [],
                              "items": {
                                "type": "object",
                                "properties": {
                                  "rank": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "description": "Backend-normalized result rank.",
                                        "example": 1
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "asin": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "description": "Amazon product ASIN.",
                                        "example": "B072MQ5BRX"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "title": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "description": "Product title.",
                                        "example": "Example product"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "imageUrl": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "description": "Matched product image URL.",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "price": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "description": "Current marketplace price.",
                                        "example": 29.99
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "rating": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "description": "Amazon rating.",
                                        "example": 4.5
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "estimatedMonthlySales": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "description": "Provider-estimated monthly sales when available.",
                                        "example": 1200
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                }
                              }
                            },
                            "caveats": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Limits on image similarity and provider estimates.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "query",
                            "matches"
                          ],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "query": {},
                    "matches": [
                      {
                        "rank": 1,
                        "asin": "B072MQ5BRX",
                        "title": "Example product",
                        "imageUrl": "https://example.com/image.jpg",
                        "price": 29.99,
                        "rating": 4.5,
                        "estimatedMonthlySales": 1200
                      }
                    ],
                    "caveats": []
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "reverse-product-image-search",
        "x-nexscope-mcp-tool-name": "nexscope_reverse_product_image_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/shopee-product-search/run": {
      "post": {
        "tags": [
          "Shopee Marketplace"
        ],
        "summary": "Shopee Product Search",
        "description": "YouYing Shopee product selection tool supporting product query and filtering across all Shopee marketplaces, covering Malaysia, Taiwan (China), Indonesia, Thailand, Philippines, Singapore, Vietnam, Brazil, Mexico, Chile, and Colombia. Triggered when users mention Shopee product selection, Shopee product search, Shopee bestsellers, Shopee market analysis, Shopee category selection, Shopee keyword selection, Shopee sales filtering, Shopee price filtering, Southeast Asia e-commerce product selection, Shopee product search, Shopee product selection, Shopee bestsellers, or Shopee market analysis. Even if the user does not explicitly mention \"YouYing\" or \"Shopee,\" this skill should be triggered whenever their need involves searching for products or filtering Shopee product data on the Shopee platform.",
        "operationId": "runShopeeProductSearch",
        "externalDocs": {
          "description": "Shopee Product Search documentation",
          "url": "https://www.nexscope.ai/api-docs/shopee-product-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.shopee-product-search.",
                "properties": {
                  "station": {
                    "type": "string",
                    "description": "Required. Shopee site, accepts name or code. See site mapping table below",
                    "example": "SG"
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Product title keyword",
                    "example": "phone case"
                  },
                  "keywordType": {
                    "type": "integer",
                    "description": "Match mode: 1=Exact phrase (default), 2=Multi-word AND, 3=Multi-word OR",
                    "example": 1
                  },
                  "notExistKeyword": {
                    "type": "string",
                    "description": "Exclude products containing this keyword",
                    "example": "phone case"
                  },
                  "notExistKeywordType": {
                    "type": "integer",
                    "description": "Exclusion match mode: 1=Exact phrase (default), 2=Multi-word AND, 3=Multi-word OR",
                    "example": 1
                  },
                  "priceMin": {
                    "type": "number",
                    "description": "Minimum total product price (local currency)",
                    "example": 1
                  },
                  "priceMax": {
                    "type": "number",
                    "description": "Maximum total product price",
                    "example": 1
                  },
                  "soldMin": {
                    "type": "integer",
                    "description": "Minimum units sold in last 30 days",
                    "example": 1
                  },
                  "soldMax": {
                    "type": "integer",
                    "description": "Maximum units sold in last 30 days",
                    "example": 1
                  },
                  "estimateSoldStart": {
                    "type": "integer",
                    "description": "Minimum estimated units sold in last 30 days",
                    "example": 1
                  },
                  "estimateSoldEnd": {
                    "type": "integer",
                    "description": "Maximum estimated units sold in last 30 days",
                    "example": 1
                  },
                  "historicalSoldStart": {
                    "type": "integer",
                    "description": "Minimum total historical units sold",
                    "example": 1
                  },
                  "historicalSoldEnd": {
                    "type": "integer",
                    "description": "Maximum total historical units sold",
                    "example": 1
                  },
                  "paymentStart": {
                    "type": "number",
                    "description": "Minimum sales revenue in last 30 days",
                    "example": 1
                  },
                  "paymentEnd": {
                    "type": "number",
                    "description": "Maximum sales revenue in last 30 days",
                    "example": 1
                  },
                  "ratingMin": {
                    "type": "number",
                    "description": "Minimum product rating (0-5)",
                    "example": 1
                  },
                  "ratingMax": {
                    "type": "number",
                    "description": "Maximum product rating",
                    "example": 1
                  },
                  "ratingsMin": {
                    "type": "integer",
                    "description": "Minimum number of ratings",
                    "example": 1
                  },
                  "ratingsMax": {
                    "type": "integer",
                    "description": "Maximum number of ratings",
                    "example": 1
                  },
                  "favoriteMin": {
                    "type": "integer",
                    "description": "Minimum number of favorites",
                    "example": 1
                  },
                  "favoriteMax": {
                    "type": "integer",
                    "description": "Maximum number of favorites",
                    "example": 1
                  },
                  "skuNumberStart": {
                    "type": "integer",
                    "description": "Minimum total SKU count",
                    "example": 1
                  },
                  "skuNumberEnd": {
                    "type": "integer",
                    "description": "Maximum total SKU count",
                    "example": 1
                  },
                  "listingDateFrom": {
                    "type": "string",
                    "description": "Product listing date range start (format: yyyy-MM-dd)",
                    "example": "2026-01-01"
                  },
                  "listingDateTo": {
                    "type": "string",
                    "description": "Product listing date range end (format: yyyy-MM-dd)",
                    "example": "2026-01-01"
                  },
                  "statTimeStart": {
                    "type": "string",
                    "description": "Statistics time range start (format: yyyy-MM-dd HH:mm:ss)"
                  },
                  "statTimeEnd": {
                    "type": "string",
                    "description": "Statistics time range end (format: yyyy-MM-dd HH:mm:ss)"
                  },
                  "lastModiTimeStart": {
                    "type": "string",
                    "description": "Latest crawl time range start (format: yyyy-MM-dd)"
                  },
                  "lastModiTimeEnd": {
                    "type": "string",
                    "description": "Latest crawl time range end (format: yyyy-MM-dd)"
                  },
                  "approvedDateStart": {
                    "type": "string",
                    "description": "Store opening time range start (format: yyyy-MM-dd)",
                    "example": "2026-01-01"
                  },
                  "approvedDateEnd": {
                    "type": "string",
                    "description": "Store opening time range end (format: yyyy-MM-dd)",
                    "example": "2026-01-01"
                  },
                  "pL1Id": {
                    "type": "string",
                    "description": "Level 1 category ID",
                    "example": "example-id"
                  },
                  "pL2Id": {
                    "type": "string",
                    "description": "Level 2 category ID",
                    "example": "example-id"
                  },
                  "pL3Id": {
                    "type": "string",
                    "description": "Level 3 category ID",
                    "example": "example-id"
                  },
                  "cidList": {
                    "type": "string",
                    "description": "Category ID list, full path, multiple groups separated by"
                  },
                  "shopIdList": {
                    "type": "string",
                    "description": "Specific store ID list, comma-separated"
                  },
                  "notExistShopIdList": {
                    "type": "string",
                    "description": "Excluded store ID list, comma-separated"
                  },
                  "merchant": {
                    "type": "string",
                    "description": "Store name or username"
                  },
                  "shopLocation": {
                    "type": "string",
                    "description": "Store location"
                  },
                  "shippingIconType": {
                    "type": "integer",
                    "description": "Store location type: 0=Local, 1=Overseas",
                    "example": 1
                  },
                  "cbOption": {
                    "type": "integer",
                    "description": "Shipping origin: 0=Local, 1=Cross-border",
                    "example": 1
                  },
                  "isShopeeVerified": {
                    "type": "integer",
                    "description": "Shopee Preferred: 0=Not preferred, 1=Preferred",
                    "example": 1
                  },
                  "isOfficialShop": {
                    "type": "integer",
                    "description": "Official store: 0=No, 1=Yes",
                    "example": 1
                  },
                  "isHotSales": {
                    "type": "integer",
                    "description": "Hot selling: 0=Not hot, 1=Hot",
                    "example": 1
                  },
                  "pids": {
                    "type": "string",
                    "description": "Product ID list (max 500), comma-separated"
                  },
                  "orderBy": {
                    "type": "string",
                    "description": "Sort field: rating, price, historical_sold (total sales), sold (30-day sales), payment (30-day revenue), favorite, ratings, gen_time (listing time), estimate_sold (estimated sales)"
                  },
                  "orderByType": {
                    "type": "string",
                    "description": "Sort direction: ASC (ascending), DESC (descending)"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Products per page (range 1-1000)",
                    "example": 10
                  }
                },
                "required": [
                  "station"
                ],
                "example": {
                  "station": "SG",
                  "pageSize": 10,
                  "keywordType": 1,
                  "keyword": "phone case",
                  "page": 1
                },
                "additionalProperties": true
              },
              "example": {
                "station": "SG",
                "pageSize": 10,
                "keywordType": 1,
                "keyword": "phone case",
                "page": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records returned in current response",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of results",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source tool identifier",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: shopee",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "pid": {
                                        "type": "string",
                                        "description": "Unique product ID",
                                        "example": "example-id"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "description": {
                                        "type": "string",
                                        "description": "Product description",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productUrl": {
                                        "type": "string",
                                        "description": "Shopee product link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "shopeeUrl": {
                                        "type": "string",
                                        "description": "Shopee-domain product link",
                                        "example": "https://shopee.sg/example-i.1.2"
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Default product price (local currency)",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Lowest SKU price",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Highest SKU price",
                                        "example": 1
                                      },
                                      "sold": {
                                        "type": "integer",
                                        "description": "Units sold in last 30 days",
                                        "example": 1
                                      },
                                      "estimateSold": {
                                        "type": "integer",
                                        "description": "Estimated units sold in last 30 days",
                                        "example": 1
                                      },
                                      "historicalSold": {
                                        "type": "integer",
                                        "description": "Total historical units sold",
                                        "example": 1
                                      },
                                      "payment": {
                                        "type": "number",
                                        "description": "Sales revenue in last 30 days (local currency)",
                                        "example": 1
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Product rating (0-5)",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Number of ratings",
                                        "example": 1
                                      },
                                      "favorite": {
                                        "type": "integer",
                                        "description": "Number of favorites",
                                        "example": 1
                                      },
                                      "viewCount": {
                                        "type": "integer",
                                        "description": "View count",
                                        "example": 1
                                      },
                                      "stock": {
                                        "type": "integer",
                                        "description": "Stock quantity",
                                        "example": 1
                                      },
                                      "skuNumber": {
                                        "type": "integer",
                                        "description": "Number of SKUs",
                                        "example": 1
                                      },
                                      "genTime": {
                                        "type": "string",
                                        "description": "Listing time",
                                        "example": null
                                      },
                                      "statTime": {
                                        "type": "string",
                                        "description": "Statistics time",
                                        "example": null
                                      },
                                      "lastModiTime": {
                                        "type": "string",
                                        "description": "Latest crawl time",
                                        "example": null
                                      },
                                      "categoryStructure": {
                                        "type": "string",
                                        "description": "Category structure path",
                                        "example": null
                                      },
                                      "cid": {
                                        "type": "string",
                                        "description": "Category ID (comma-separated)",
                                        "example": "example-id"
                                      },
                                      "shopId": {
                                        "type": "string",
                                        "description": "Store ID",
                                        "example": "example-id"
                                      },
                                      "shopName": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "shopUrl": {
                                        "type": "string",
                                        "description": "Store link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "userName": {
                                        "type": "string",
                                        "description": "Store owner name",
                                        "example": null
                                      },
                                      "shopLocation": {
                                        "type": "string",
                                        "description": "Store location",
                                        "example": null
                                      },
                                      "shopProductsCount": {
                                        "type": "integer",
                                        "description": "Total products in store",
                                        "example": 1
                                      },
                                      "approvedDate": {
                                        "type": "string",
                                        "description": "Store opening time",
                                        "example": "2026-01-01"
                                      },
                                      "isOfficialShop": {
                                        "type": "integer",
                                        "description": "Whether official store (1=Yes, 0=No)",
                                        "example": 1
                                      },
                                      "isShopeeVerified": {
                                        "type": "integer",
                                        "description": "Shopee Preferred (1=Yes, 0=No)",
                                        "example": 1
                                      },
                                      "isHotSales": {
                                        "type": "integer",
                                        "description": "Whether hot selling (1=Yes, 0=No)",
                                        "example": 1
                                      },
                                      "shippingIconType": {
                                        "type": "integer",
                                        "description": "Store location type (0=Local, 1=Overseas, 3 or null=Unknown)",
                                        "example": 1
                                      },
                                      "cbOption": {
                                        "type": "integer",
                                        "description": "Shipping origin (0=Local, 1=Cross-border)",
                                        "example": 1
                                      },
                                      "estimatedDays": {
                                        "type": "integer",
                                        "description": "Estimated delivery days",
                                        "example": 1
                                      },
                                      "status": {
                                        "type": "integer",
                                        "description": "Product status (1=Active, 0=Delisted, 8=Excluded from listing)",
                                        "example": 1
                                      },
                                      "notExist": {
                                        "type": "integer",
                                        "description": "Whether exists (0=Exists, 1=Does not exist)",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "totalSize": 1,
                    "columns": [],
                    "costToken": 1,
                    "products": [
                      {
                        "pid": "example-id",
                        "imageUrl": "https://example.com/image.jpg",
                        "productUrl": "https://example.com/image.jpg",
                        "shopeeUrl": "https://shopee.sg/example-i.1.2",
                        "price": 1,
                        "minPrice": 1,
                        "maxPrice": 1,
                        "sold": 1,
                        "estimateSold": 1,
                        "historicalSold": 1,
                        "payment": 1,
                        "rating": 1,
                        "ratings": 1,
                        "favorite": 1,
                        "viewCount": 1,
                        "stock": 1,
                        "skuNumber": 1,
                        "cid": "example-id",
                        "shopId": "example-id",
                        "shopUrl": "https://example.com/image.jpg",
                        "shopProductsCount": 1,
                        "approvedDate": "2026-01-01",
                        "isOfficialShop": 1,
                        "isShopeeVerified": 1,
                        "isHotSales": 1,
                        "shippingIconType": 1,
                        "cbOption": 1,
                        "estimatedDays": 1,
                        "status": 1,
                        "notExist": 1
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "shopee-product-search",
        "x-nexscope-mcp-tool-name": "nexscope_shopee_product_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/shopify-product-query/run": {
      "post": {
        "tags": [
          "Shopify Commerce"
        ],
        "summary": "Shopify Product Query",
        "description": "Filter Shopify standalone store products by multiple dimensions (keyword/URL, price, weekly sales, listing date, Facebook ads, competitiveness, supplier availability, shipping country, etc.). Triggered when users mention Shopify products, Shopify product selection, standalone store product selection, Shopify bestsellers, Shopify dropshipping, standalone store sourcing, Facebook ad products, Shopify product query, or shopify items. Even if the user does not mention the tool name, this skill should be triggered whenever searching for products, viewing weekly sales/revenue/competitiveness, or filtering products on Shopify standalone stores.",
        "operationId": "runShopifyProductQuery",
        "externalDocs": {
          "description": "Shopify Product Query documentation",
          "url": "https://www.nexscope.ai/api-docs/shopify-product-query"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.shopify-product-query.",
                "properties": {
                  "searchKey": {
                    "type": "string",
                    "description": "Keyword or Shopify product/store URL"
                  },
                  "priceMin": {
                    "type": "number",
                    "description": "Price range start (USD), combined with priceMax to form upstream price",
                    "example": 1
                  },
                  "priceMax": {
                    "type": "number",
                    "description": "Price range end (USD)",
                    "example": 1
                  },
                  "salesWeeklyMin": {
                    "type": "integer",
                    "description": "Weekly sales range start",
                    "example": 1
                  },
                  "salesWeeklyMax": {
                    "type": "integer",
                    "description": "Weekly sales range end",
                    "example": 1
                  },
                  "publishedTimeBegin": {
                    "type": "string",
                    "description": "Listing date range start"
                  },
                  "publishedTimeEnd": {
                    "type": "string",
                    "description": "Listing date range end"
                  },
                  "facebookAd": {
                    "type": "integer",
                    "description": "Has Facebook ad: 1=Yes",
                    "example": 1
                  },
                  "competitionMin": {
                    "type": "integer",
                    "description": "Competition (number of stores selling) range start",
                    "example": 1
                  },
                  "competitionMax": {
                    "type": "integer",
                    "description": "Competition (number of stores selling) range end",
                    "example": 1
                  },
                  "hasSupplier": {
                    "type": "integer",
                    "description": "Has supplier: 1=Yes, 0=No",
                    "example": 1
                  },
                  "showDeleted": {
                    "type": "integer",
                    "description": "Show delisted products: 1=Yes, 0=No",
                    "example": 1
                  },
                  "country": {
                    "type": "string",
                    "description": "Shipping country (two-letter country code, e.g., US)"
                  },
                  "sortBy": {
                    "type": "integer",
                    "description": "Sort field (default 14=Weekly sales descending; also includes price/ad count/competition/revenue etc. values, see enumeration below)",
                    "example": 1
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page, max 100, recommended not to exceed 50",
                    "example": 1
                  },
                  "keyword": {
                    "type": "string"
                  }
                },
                "example": {
                  "page": 1,
                  "keyword": "phone case",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "phone case",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of results returned on this page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "productNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matching products (upstream product_num)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Shopify product list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "example-id"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "productLink": {
                                        "type": "string",
                                        "description": "Product link",
                                        "example": null
                                      },
                                      "previewImageUrl": {
                                        "type": "string",
                                        "description": "Main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "country": {
                                        "type": "string",
                                        "description": "Shipping country",
                                        "example": null
                                      },
                                      "minPrice": {
                                        "type": "string",
                                        "description": "Minimum price",
                                        "example": null
                                      },
                                      "maxPrice": {
                                        "type": "string",
                                        "description": "Maximum price",
                                        "example": null
                                      },
                                      "storeId": {
                                        "type": "string",
                                        "description": "Store ID",
                                        "example": "example-id"
                                      },
                                      "shopId": {
                                        "type": "string",
                                        "description": "Shopify shop ID",
                                        "example": "example-id"
                                      },
                                      "storeLink": {
                                        "type": "string",
                                        "description": "Store link",
                                        "example": null
                                      },
                                      "storeRank": {
                                        "type": "string",
                                        "description": "Store rank",
                                        "example": null
                                      },
                                      "competitorCount": {
                                        "type": "string",
                                        "description": "Competition (number of stores selling)",
                                        "example": null
                                      },
                                      "facebookAdCount": {
                                        "type": "string",
                                        "description": "Facebook ad count",
                                        "example": null
                                      },
                                      "weekOrderCount": {
                                        "type": "string",
                                        "description": "Weekly order count (string)",
                                        "example": null
                                      },
                                      "weekRevenueCount": {
                                        "type": "string",
                                        "description": "Weekly revenue",
                                        "example": null
                                      },
                                      "weekRevenueGrowth": {
                                        "type": "string",
                                        "description": "Weekly revenue growth rate (%)",
                                        "example": null
                                      },
                                      "shelfTime": {
                                        "type": "string",
                                        "description": "Listing time",
                                        "example": null
                                      },
                                      "isDeleted": {
                                        "type": "string",
                                        "description": "Whether delisted: 0=Listed, 1=Delisted",
                                        "example": null
                                      },
                                      "isFavourite": {
                                        "type": "string",
                                        "description": "Whether favorited",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Columns for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title (Shopify Product Query)",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: shopify",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Tool type: ehunt",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style: tableListWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "productNum": 1,
                    "products": [
                      {
                        "productId": "example-id",
                        "previewImageUrl": "https://example.com/image.jpg",
                        "storeId": "example-id",
                        "shopId": "example-id"
                      }
                    ],
                    "columns": []
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "shopify-product-query",
        "x-nexscope-mcp-tool-name": "nexscope_shopify_product_query",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/shopify-store-query/run": {
      "post": {
        "tags": [
          "Shopify Commerce"
        ],
        "summary": "Shopify Store Query",
        "description": "Filter Shopify standalone stores by multiple dimensions (store name/domain, country, years since creation, product count, ad count, monthly visits, monthly orders, social media followers, etc.). Triggered when users mention Shopify stores, Shopify store analysis, standalone stores, Shopify sellers, competitor standalone stores, Shopify monthly visits, standalone store ad library, shopify stores, or Shopify store query. Even if the user does not mention the tool name, this skill should be triggered whenever searching for stores, filtering store data, or analyzing store performance on Shopify standalone stores.",
        "operationId": "runShopifyStoreQuery",
        "externalDocs": {
          "description": "Shopify Store Query documentation",
          "url": "https://www.nexscope.ai/api-docs/shopify-store-query"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.shopify-store-query.",
                "properties": {
                  "searchKey": {
                    "type": "string",
                    "description": "Store name or domain keyword"
                  },
                  "country": {
                    "type": "string",
                    "description": "Country code (e.g., US, CN)"
                  },
                  "year": {
                    "type": "integer",
                    "description": "Store creation year: 1=Last 1 year, 2=1~2 years, 3=2~3 years, 4=3+ years",
                    "example": 1
                  },
                  "productNumMin": {
                    "type": "integer",
                    "description": "Product count range start",
                    "example": 1
                  },
                  "productNumMax": {
                    "type": "integer",
                    "description": "Product count range end",
                    "example": 1
                  },
                  "advertiseCountMin": {
                    "type": "integer",
                    "description": "Ad count range start",
                    "example": 1
                  },
                  "advertiseCountMax": {
                    "type": "integer",
                    "description": "Ad count range end",
                    "example": 1
                  },
                  "monthlyVisitMin": {
                    "type": "integer",
                    "description": "Monthly visits range start",
                    "example": 1
                  },
                  "monthlyVisitMax": {
                    "type": "integer",
                    "description": "Monthly visits range end",
                    "example": 1
                  },
                  "monthOrderMin": {
                    "type": "integer",
                    "description": "Monthly orders range start",
                    "example": 1
                  },
                  "monthOrderMax": {
                    "type": "integer",
                    "description": "Monthly orders range end",
                    "example": 1
                  },
                  "sortBy": {
                    "type": "integer",
                    "description": "Sort field: 0=Product count, 1=Category count, 2=Monthly visits, 3=FB followers, 4=Ins followers, 5=Ad count, 6=Relevance, 7=Monthly orders (default)",
                    "example": 1
                  },
                  "orderBy": {
                    "type": "string",
                    "description": "Sort direction: desc (default) / asc"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page, max 100",
                    "example": 1
                  },
                  "keyword": {
                    "type": "string"
                  }
                },
                "example": {
                  "page": 1,
                  "keyword": "phone case",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "phone case",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of results returned on this page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "storeNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matching stores (upstream store_num)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "stores": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Shopify store list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "storeId": {
                                        "type": "string",
                                        "description": "Store ID",
                                        "example": "example-id"
                                      },
                                      "shopId": {
                                        "type": "string",
                                        "description": "Shopify shop ID",
                                        "example": "example-id"
                                      },
                                      "storeName": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "storeDomain": {
                                        "type": "string",
                                        "description": "Store domain",
                                        "example": null
                                      },
                                      "storeLink": {
                                        "type": "string",
                                        "description": "Store link",
                                        "example": null
                                      },
                                      "country": {
                                        "type": "string",
                                        "description": "Country",
                                        "example": null
                                      },
                                      "createdTime": {
                                        "type": "string",
                                        "description": "Creation time",
                                        "example": null
                                      },
                                      "productNum": {
                                        "type": "string",
                                        "description": "Product count",
                                        "example": null
                                      },
                                      "categoryNum": {
                                        "type": "string",
                                        "description": "Category count",
                                        "example": null
                                      },
                                      "categories": {
                                        "type": "array",
                                        "description": "Category list (elements contain id and name)",
                                        "example": null
                                      },
                                      "monthlyVisit": {
                                        "type": "string",
                                        "description": "Monthly visits (formatted)",
                                        "example": null
                                      },
                                      "monthOrderNum": {
                                        "type": "string",
                                        "description": "Monthly orders (formatted)",
                                        "example": null
                                      },
                                      "fbFollowers": {
                                        "type": "string",
                                        "description": "Facebook followers",
                                        "example": null
                                      },
                                      "insFollowers": {
                                        "type": "string",
                                        "description": "Instagram followers",
                                        "example": null
                                      },
                                      "advertiseCount": {
                                        "type": "string",
                                        "description": "Ad count",
                                        "example": null
                                      },
                                      "adLink": {
                                        "type": "string",
                                        "description": "Ad library link",
                                        "example": null
                                      },
                                      "email": {
                                        "type": "string",
                                        "description": "Contact email",
                                        "example": null
                                      },
                                      "facebookUrl": {
                                        "type": "string",
                                        "description": "Facebook page",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "instagramUrl": {
                                        "type": "string",
                                        "description": "Instagram page",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "socialLinks": {
                                        "type": "object",
                                        "description": "Social media links (Map)",
                                        "example": null
                                      },
                                      "globalRank": {
                                        "type": "string",
                                        "description": "Global rank",
                                        "example": null
                                      },
                                      "logo": {
                                        "type": "string",
                                        "description": "Store logo URL",
                                        "example": null
                                      },
                                      "availableStatus": {
                                        "type": "string",
                                        "description": "Whether active: 1=Active",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Columns for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title (Shopify Store Query)",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: shopify",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Tool type: ehunt",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style: tableListWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "storeNum": 1,
                    "stores": [
                      {
                        "storeId": "example-id",
                        "shopId": "example-id",
                        "facebookUrl": "https://example.com/image.jpg",
                        "instagramUrl": "https://example.com/image.jpg"
                      }
                    ],
                    "columns": []
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "shopify-store-query",
        "x-nexscope-mcp-tool-name": "nexscope_shopify_store_query",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/temu-category-search/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Temu Category Search",
        "description": "Search synced Temu category data in the local database by keyword to find category Chinese names, English names, and category IDs for use in product/store filtering. Triggered when users mention Temu categories, Temu category ID, Temu category tree, Temu backend categories, temu categories, syncTemuCategory (Temu category sync) followed by category queries, or Temu category search. Even if the user does not mention the tool name, this skill should be triggered whenever searching for category IDs by keyword in the locally synced Temu category database.",
        "operationId": "runTemuCategorySearch",
        "externalDocs": {
          "description": "Temu Category Search documentation",
          "url": "https://www.nexscope.ai/api-docs/temu-category-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.temu-category-search.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Keyword: matches against category Chinese name, English name, category ID (substring)",
                    "example": "home"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page, max 200",
                    "example": 10
                  }
                },
                "required": [
                  "keyword"
                ],
                "example": {
                  "page": 1,
                  "keyword": "home",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "home",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of results returned on this page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "categories": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "List of matching categories",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "description": "Category ID",
                                        "example": "example-id"
                                      },
                                      "categoryId": {
                                        "type": "string",
                                        "description": "Category ID (upstream category id)",
                                        "example": "example-id"
                                      },
                                      "parentId": {
                                        "type": "string",
                                        "description": "Parent category ID (empty string for top-level)",
                                        "example": "example-id"
                                      },
                                      "level": {
                                        "type": "integer",
                                        "description": "Category hierarchy level",
                                        "example": 1
                                      },
                                      "categoryName": {
                                        "type": "string",
                                        "description": "Category name (Chinese)",
                                        "example": null
                                      },
                                      "categoryNameEn": {
                                        "type": "string",
                                        "description": "Category name (English)",
                                        "example": null
                                      },
                                      "isDeleted": {
                                        "type": "integer",
                                        "description": "Whether deleted: 0=Normal, 1=Deleted",
                                        "example": 1
                                      },
                                      "hasChildren": {
                                        "type": "boolean",
                                        "description": "Whether has child categories",
                                        "example": false
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider title for the Temu category search; the documented upstream value is in Chinese.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "categories": [
                      {
                        "id": "example-id",
                        "categoryId": "example-id",
                        "parentId": "example-id",
                        "level": 1,
                        "isDeleted": 1,
                        "hasChildren": false
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "temu-category-search",
        "x-nexscope-mcp-tool-name": "nexscope_temu_category_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/temu-product-source-query/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Temu Product Source Query",
        "description": "Filter Temu products by multiple dimensions (keyword/product ID/store ID, front/backend categories, price, rating, reviews, total/weekly/daily sales, listing date, fully-managed/semi-managed, semi-managed regions, tags, etc.). Triggered when users mention Temu products, Temu product selection, Pinduoduo cross-border, Temu bestsellers, Temu semi-managed, fully-managed products, Temu product query, or temu items. Even if the user does not mention the tool name, this skill should be triggered whenever searching for products, viewing sales/ratings/prices, or filtering products on Temu.",
        "operationId": "runTemuProductSourceQuery",
        "externalDocs": {
          "description": "Temu Product Source Query documentation",
          "url": "https://www.nexscope.ai/api-docs/temu-product-source-query"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.temu-product-source-query.",
                "properties": {
                  "searchKey": {
                    "type": "string",
                    "description": "Keyword or product ID / store ID"
                  },
                  "categoryHome": {
                    "type": "string",
                    "description": "Front-end category ID"
                  },
                  "categoryBackend": {
                    "type": "string",
                    "description": "Back-end category ID"
                  },
                  "priceBegin": {
                    "type": "number",
                    "description": "Price range start (USD), combined to form upstream price",
                    "example": 1
                  },
                  "priceEnd": {
                    "type": "number",
                    "description": "Price range end (USD)",
                    "example": 1
                  },
                  "ratingBegin": {
                    "type": "number",
                    "description": "Rating range start, combined to form upstream rating",
                    "example": 1
                  },
                  "ratingEnd": {
                    "type": "number",
                    "description": "Rating range end",
                    "example": 1
                  },
                  "reviewsBegin": {
                    "type": "integer",
                    "description": "Review count range start, combined to form reviews",
                    "example": 1
                  },
                  "reviewsEnd": {
                    "type": "integer",
                    "description": "Review count range end",
                    "example": 1
                  },
                  "salesTotalBegin": {
                    "type": "integer",
                    "description": "Total sales range start, combined to form sales_total",
                    "example": 1
                  },
                  "salesTotalEnd": {
                    "type": "integer",
                    "description": "Total sales range end",
                    "example": 1
                  },
                  "salesWeeklyBegin": {
                    "type": "integer",
                    "description": "Weekly sales range start, combined to form sales_weekly",
                    "example": 1
                  },
                  "salesWeeklyEnd": {
                    "type": "integer",
                    "description": "Weekly sales range end",
                    "example": 1
                  },
                  "salesDailyBegin": {
                    "type": "integer",
                    "description": "Daily sales range start, combined to form sales_daily",
                    "example": 1
                  },
                  "salesDailyEnd": {
                    "type": "integer",
                    "description": "Daily sales range end",
                    "example": 1
                  },
                  "publishTimeBegin": {
                    "type": "string",
                    "description": "Listing date range start, combined to form publish_time"
                  },
                  "publishTimeEnd": {
                    "type": "string",
                    "description": "Listing date range end"
                  },
                  "soldOut": {
                    "type": "integer",
                    "description": "Whether delisted: 0=Listed, 1=Delisted",
                    "example": 1
                  },
                  "isLocal": {
                    "type": "integer",
                    "description": "Whether semi-managed: 0=Fully managed, 1=Semi-managed",
                    "example": 1
                  },
                  "region": {
                    "type": "string",
                    "description": "Semi-managed regions, comma-separated",
                    "example": "US"
                  },
                  "tags": {
                    "type": "string",
                    "description": "Product tags, comma-separated"
                  },
                  "customTags": {
                    "type": "string",
                    "description": "Custom tags, comma-separated"
                  },
                  "sortBy": {
                    "type": "string",
                    "description": "Sort field+direction: order_week-0 (weekly sales descending, default), price-0, order_total-0, rating-0, etc."
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Results per page, max 100, recommended not to exceed 50",
                    "example": 1
                  },
                  "keyword": {
                    "type": "string"
                  }
                },
                "example": {
                  "page": 1,
                  "keyword": "phone case",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "phone case",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of results returned on this page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "productNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matching products (upstream product_num)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Temu product list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "example-id"
                                      },
                                      "productName": {
                                        "type": "string",
                                        "description": "Product name (English)",
                                        "example": null
                                      },
                                      "productNameCn": {
                                        "type": "string",
                                        "description": "Product name (Chinese)",
                                        "example": null
                                      },
                                      "logoUrl": {
                                        "type": "string",
                                        "description": "Main image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "price": {
                                        "type": "string",
                                        "description": "Price",
                                        "example": null
                                      },
                                      "orderTotal": {
                                        "type": "string",
                                        "description": "Total sales",
                                        "example": null
                                      },
                                      "orderWeek": {
                                        "type": "string",
                                        "description": "Weekly sales",
                                        "example": null
                                      },
                                      "orderDay": {
                                        "type": "string",
                                        "description": "Daily sales",
                                        "example": null
                                      },
                                      "orderMonth": {
                                        "type": "string",
                                        "description": "Monthly sales",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "string",
                                        "description": "Rating",
                                        "example": null
                                      },
                                      "reviewNum": {
                                        "type": "string",
                                        "description": "Review count",
                                        "example": null
                                      },
                                      "publishTime": {
                                        "type": "string",
                                        "description": "Listing time",
                                        "example": null
                                      },
                                      "soldOut": {
                                        "type": "string",
                                        "description": "Whether delisted",
                                        "example": null
                                      },
                                      "isLocal": {
                                        "type": "string",
                                        "description": "Whether semi-managed: 0=Fully managed, 1=Semi-managed",
                                        "example": null
                                      },
                                      "localRegion": {
                                        "type": "string",
                                        "description": "Semi-managed region list",
                                        "example": null
                                      },
                                      "storeId": {
                                        "type": "string",
                                        "description": "Store ID",
                                        "example": "example-id"
                                      },
                                      "tags": {
                                        "type": "string",
                                        "description": "Tag list",
                                        "example": null
                                      },
                                      "customTags": {
                                        "type": "string",
                                        "description": "Custom tags",
                                        "example": null
                                      },
                                      "categoryHome": {
                                        "type": "string",
                                        "description": "Front-end category",
                                        "example": null
                                      },
                                      "categoryBackend": {
                                        "type": "string",
                                        "description": "Back-end category",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Columns for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title (Temu Product Query)",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: temu",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Tool type: ehunt",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style: tableListWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "productNum": 1,
                    "products": [
                      {
                        "productId": "example-id",
                        "logoUrl": "https://example.com/image.jpg",
                        "storeId": "example-id"
                      }
                    ],
                    "columns": []
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "temu-product-source-query",
        "x-nexscope-mcp-tool-name": "nexscope_temu_product_source_query",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/temu-store-source-query/run": {
      "post": {
        "tags": [
          "Temu Marketplace Intelligence"
        ],
        "summary": "Temu Store Source Query",
        "description": "Filter Temu stores by multiple dimensions (store name/ID, country site, backend category, fully-managed/semi-managed, total/weekly/monthly sales and revenue, rating, reviews, followers, product count, store opening time, etc.). Trigger when users mention Temu store, Temu store analysis, Temu seller, Temu store ranking, Temu semi-managed store, Temu revenue, temu stores, Temu store query. Even if the user does not mention the tool name, trigger this skill whenever they are looking for stores on Temu, filtering store data, or analyzing store performance.",
        "operationId": "runTemuStoreSourceQuery",
        "externalDocs": {
          "description": "Temu Store Source Query documentation",
          "url": "https://www.nexscope.ai/api-docs/temu-store-source-query"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.temu-store-source-query.",
                "properties": {
                  "searchKey": {
                    "type": "string",
                    "description": "Store name or ID keyword"
                  },
                  "siteId": {
                    "type": "string",
                    "description": "Country site ID, multiple separated by commas (e.g., 211=US, 76=UK)",
                    "example": "example-id"
                  },
                  "category": {
                    "type": "string",
                    "description": "Backend category ID, multiple separated by commas"
                  },
                  "isLocal": {
                    "type": "string",
                    "description": "Whether semi-managed: 0=fully managed, 1=semi-managed"
                  },
                  "orderTotalMin": {
                    "type": "integer",
                    "description": "Total sales range (start)",
                    "example": 1
                  },
                  "orderTotalMax": {
                    "type": "integer",
                    "description": "Total sales range (end)",
                    "example": 1
                  },
                  "orderWeekMin": {
                    "type": "integer",
                    "description": "Weekly sales range (start)",
                    "example": 1
                  },
                  "orderWeekMax": {
                    "type": "integer",
                    "description": "Weekly sales range (end)",
                    "example": 1
                  },
                  "orderMonthMin": {
                    "type": "integer",
                    "description": "Monthly sales range (start)",
                    "example": 1
                  },
                  "orderMonthMax": {
                    "type": "integer",
                    "description": "Monthly sales range (end)",
                    "example": 1
                  },
                  "totalRevenueMin": {
                    "type": "number",
                    "description": "Total revenue range (USD, start)",
                    "example": 1
                  },
                  "totalRevenueMax": {
                    "type": "number",
                    "description": "Total revenue range (USD, end)",
                    "example": 1
                  },
                  "weekRevenueMin": {
                    "type": "number",
                    "description": "Weekly revenue range (USD, start)",
                    "example": 1
                  },
                  "weekRevenueMax": {
                    "type": "number",
                    "description": "Weekly revenue range (USD, end)",
                    "example": 1
                  },
                  "monthRevenueMin": {
                    "type": "number",
                    "description": "Monthly revenue range (USD, start)",
                    "example": 1
                  },
                  "monthRevenueMax": {
                    "type": "number",
                    "description": "Monthly revenue range (USD, end)",
                    "example": 1
                  },
                  "ratingMin": {
                    "type": "number",
                    "description": "Rating range (start)",
                    "example": 1
                  },
                  "ratingMax": {
                    "type": "number",
                    "description": "Rating range (end)",
                    "example": 1
                  },
                  "reviewNumMin": {
                    "type": "integer",
                    "description": "Review count range (start)",
                    "example": 1
                  },
                  "reviewNumMax": {
                    "type": "integer",
                    "description": "Review count range (end)",
                    "example": 1
                  },
                  "followerNumMin": {
                    "type": "integer",
                    "description": "Follower count range (start)",
                    "example": 1
                  },
                  "followerNumMax": {
                    "type": "integer",
                    "description": "Follower count range (end)",
                    "example": 1
                  },
                  "productNumMin": {
                    "type": "integer",
                    "description": "Product count range (start)",
                    "example": 1
                  },
                  "productNumMax": {
                    "type": "integer",
                    "description": "Product count range (end)",
                    "example": 1
                  },
                  "listedTimeBegin": {
                    "type": "string",
                    "description": "Store opening date range (start)"
                  },
                  "listedTimeEnd": {
                    "type": "string",
                    "description": "Store opening date range (end)"
                  },
                  "sortBy": {
                    "type": "string",
                    "description": "Sort field+direction: order_week_count-0 (weekly sales descending, default), order_count-0, total_revenue-0, rating-0"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number (starting from 1)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, max 100",
                    "example": 1
                  },
                  "keyword": {
                    "type": "string"
                  }
                },
                "example": {
                  "page": 1,
                  "keyword": "phone case",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "phone case",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records on this page",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "storeNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of stores matching criteria (upstream store_num)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "stores": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Temu store list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "storeId": {
                                        "type": "string",
                                        "description": "Store ID",
                                        "example": "example-id"
                                      },
                                      "siteId": {
                                        "type": "string",
                                        "description": "Country site ID",
                                        "example": "example-id"
                                      },
                                      "storeName": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "logoUrl": {
                                        "type": "string",
                                        "description": "Store logo URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "orderTotal": {
                                        "type": "string",
                                        "description": "Total sales",
                                        "example": null
                                      },
                                      "orderWeek": {
                                        "type": "string",
                                        "description": "Weekly sales",
                                        "example": null
                                      },
                                      "orderMonth": {
                                        "type": "string",
                                        "description": "Monthly sales",
                                        "example": null
                                      },
                                      "totalRevenue": {
                                        "type": "string",
                                        "description": "Total revenue",
                                        "example": null
                                      },
                                      "weekRevenue": {
                                        "type": "string",
                                        "description": "Weekly revenue",
                                        "example": null
                                      },
                                      "monthRevenue": {
                                        "type": "string",
                                        "description": "Monthly revenue",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "string",
                                        "description": "Rating",
                                        "example": null
                                      },
                                      "listedTime": {
                                        "type": "string",
                                        "description": "Store opening time",
                                        "example": null
                                      },
                                      "reviewNum": {
                                        "type": "string",
                                        "description": "Review count",
                                        "example": null
                                      },
                                      "followerNum": {
                                        "type": "string",
                                        "description": "Follower count",
                                        "example": null
                                      },
                                      "productNum": {
                                        "type": "string",
                                        "description": "Product count",
                                        "example": null
                                      },
                                      "categoriesCn": {
                                        "type": "string",
                                        "description": "Chinese category list",
                                        "example": null
                                      },
                                      "categories": {
                                        "type": "string",
                                        "description": "English category list",
                                        "example": null
                                      },
                                      "isLocal": {
                                        "type": "string",
                                        "description": "Whether semi-managed: 0=fully managed, 1=semi-managed",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Title (Temu Store Query)",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: temu",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Tool type: ehunt",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style: tableListWorkbenches",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "storeNum": 1,
                    "stores": [
                      {
                        "storeId": "example-id",
                        "siteId": "example-id",
                        "logoUrl": "https://example.com/image.jpg"
                      }
                    ],
                    "columns": []
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "temu-store-source-query",
        "x-nexscope-mcp-tool-name": "nexscope_temu_store_source_query",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/text-trademark-detector/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Text Trademark Detector",
        "description": "Text trademark detection and infringement risk analysis for e-commerce product listings. Trigger when users mention trademark detection, trademark risk check, brand infringement screening, product title trademark scan, text trademark search, listing compliance check, intellectual property risk assessment, text trademark detection, trademark infringement, brand infringement screening, listing compliance, intellectual property risk, Ruiguan. Even if the user does not explicitly say \"trademark\", trigger this skill whenever their need involves checking whether product text (titles, descriptions, bullet points) contains potentially infringing trademarks.",
        "operationId": "runTextTrademarkDetector",
        "externalDocs": {
          "description": "Text Trademark Detector documentation",
          "url": "https://www.nexscope.ai/api-docs/text-trademark-detector"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.text-trademark-detector.",
                "properties": {
                  "productTitle": {
                    "type": "string",
                    "description": "Product title, used for trademark detection (max 1000 characters)",
                    "example": "MagSafe Phone Case for iPhone"
                  },
                  "regions": {
                    "type": "string",
                    "description": "Country/region codes, multiple separated by commas. Supported values: US, EM, GB, DE, FR, IT, ES, AU, CA, MX, JP, CN, WO, TR, BX",
                    "example": "US"
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Limit on the number of returned results (default 100, max 500)",
                    "example": 10
                  },
                  "productText": {
                    "type": "string",
                    "description": "Other product text information, such as bullet points or product description (max 1000 characters)",
                    "example": "Protective magnetic phone case with shockproof corners."
                  }
                },
                "required": [
                  "productTitle",
                  "limit"
                ],
                "example": {
                  "regions": "US",
                  "productText": "Protective magnetic phone case with shockproof corners.",
                  "limit": 10,
                  "productTitle": "MagSafe Phone Case for iPhone"
                },
                "additionalProperties": true
              },
              "example": {
                "regions": "US",
                "productText": "Protective magnetic phone case with shockproof corners.",
                "limit": 10,
                "productTitle": "MagSafe Phone Case for iPhone"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of matched trademark records",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Trademark list (flattened), each element contains the following fields",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "textTrademarkRadar": {
                                        "type": "string",
                                        "description": "Product risk level: \"0\" = low risk, \"1\" = pending manual review, \"2\" = high risk",
                                        "example": null
                                      },
                                      "trademarkName": {
                                        "type": "string",
                                        "description": "Trademark word",
                                        "example": null
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Country/region code",
                                        "example": "US"
                                      },
                                      "score": {
                                        "type": "integer",
                                        "description": "Risk score",
                                        "example": 1
                                      },
                                      "highestModeScore": {
                                        "type": "integer",
                                        "description": "Highest risk score (range 0-5)",
                                        "example": 1
                                      },
                                      "trademarksStatus": {
                                        "type": "string",
                                        "description": "Status of the highest-score trademark word",
                                        "example": null
                                      },
                                      "regionStatus": {
                                        "type": "string",
                                        "description": "Trademark status in the matched region",
                                        "example": null
                                      },
                                      "holder": {
                                        "type": "string",
                                        "description": "Rights holder",
                                        "example": null
                                      },
                                      "applicationNumber": {
                                        "type": "string",
                                        "description": "Application number",
                                        "example": null
                                      },
                                      "registrationNumber": {
                                        "type": "string",
                                        "description": "Registration number",
                                        "example": null
                                      },
                                      "isFamous": {
                                        "type": "boolean",
                                        "description": "Whether it is a famous trademark",
                                        "example": false
                                      },
                                      "isAmazonBrand": {
                                        "type": "boolean",
                                        "description": "Whether it is an Amazon hot search brand",
                                        "example": false
                                      },
                                      "isActiveHolder": {
                                        "type": "boolean",
                                        "description": "Whether the holder is an active enforcer",
                                        "example": false
                                      },
                                      "isCompatibility": {
                                        "type": "boolean",
                                        "description": "Whether it is compatibility",
                                        "example": false
                                      },
                                      "isCommonSense": {
                                        "type": "boolean",
                                        "description": "Whether it is a common word",
                                        "example": false
                                      },
                                      "niceClass": {
                                        "type": "array",
                                        "description": "Nice classification",
                                        "example": []
                                      },
                                      "originalTextMatches": {
                                        "type": "array",
                                        "description": "Original matched trigger words",
                                        "example": []
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "detectId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "API call ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "blacklistTrademarks": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Blacklisted trademarks detected in the text",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "trademark": {
                                        "type": "string",
                                        "description": "Trademark name",
                                        "example": null
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Country/region code",
                                        "example": "US"
                                      },
                                      "note": {
                                        "type": "string",
                                        "description": "Remarks",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "whitelistTrademarks": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Whitelisted (safe) trademarks detected in the text",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "trademark": {
                                        "type": "string",
                                        "description": "Trademark name",
                                        "example": null
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Country/region code",
                                        "example": "US"
                                      },
                                      "note": {
                                        "type": "string",
                                        "description": "Remarks",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "region": "US",
                        "score": 1,
                        "highestModeScore": 1,
                        "isFamous": false,
                        "isAmazonBrand": false,
                        "isActiveHolder": false,
                        "isCompatibility": false,
                        "isCommonSense": false,
                        "niceClass": [],
                        "originalTextMatches": []
                      }
                    ],
                    "detectId": "example-id",
                    "columns": [],
                    "blacklistTrademarks": [
                      {
                        "region": "US"
                      }
                    ],
                    "whitelistTrademarks": [
                      {
                        "region": "US"
                      }
                    ],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "text-trademark-detector",
        "x-nexscope-mcp-tool-name": "nexscope_text_trademark_detector",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-batch-product-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Batch Product Detail",
        "description": "Batch query TikTok product detail data, including multi-period sales and GMV (1d/7d/15d/30d/60d/90d/cumulative), live sales and live GMV, promoting video and creator data, views, price, rating, review count, commission rate, and delisted/fully-managed status. Supports batch retrieval by product ID or TikTok Shop product URL. Trigger when users mention TikTok product detail, batch query TikTok products, TikTok product sales analysis, TikTok product GMV, TikTok live sales, TikTok influencer sales data, TikTok product price rating, batch get TikTok product info, Nexscope product detail, TikTok product detail, batch product lookup, TikTok sales analysis, TikTok GMV, TikTok live sales, TikTok influencer data. Even if the user does not explicitly mention \"Nexscope\", trigger this skill whenever their need involves batch retrieval of detailed TikTok product sales and marketing data by product ID or product URL.",
        "operationId": "runTiktokBatchProductDetail",
        "externalDocs": {
          "description": "Tiktok Batch Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-batch-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-batch-product-detail.",
                "properties": {
                  "productIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "List of product IDs (max 1000). Example: [\"1729382310407603945\", \"1729382310407603946\"]",
                    "example": [
                      "1732294342978343112"
                    ]
                  },
                  "productUrls": {
                    "type": "array",
                    "items": {},
                    "description": "List of product URLs (max 1000), in the form https://shop.tiktok.com/us/pdp/<slug>/<productId>?...; the backend will extract the trailing productId from each URL and merge into productIds, not mutually exclusive with productIds",
                    "example": []
                  }
                },
                "example": {
                  "productIds": [
                    "1732294342978343112"
                  ]
                },
                "additionalProperties": true
              },
              "example": {
                "productIds": [
                  "1732294342978343112"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product detail list (see product object below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "example-id"
                                      },
                                      "productName": {
                                        "type": "string",
                                        "description": "Product name",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Product image URL list",
                                        "example": []
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Region code",
                                        "example": "US"
                                      },
                                      "sellerId": {
                                        "type": "string",
                                        "description": "Seller ID",
                                        "example": "example-id"
                                      },
                                      "categoryId": {
                                        "type": "string",
                                        "description": "Primary category ID",
                                        "example": "example-id"
                                      },
                                      "categoryL2Id": {
                                        "type": "string",
                                        "description": "Secondary category ID",
                                        "example": "example-id"
                                      },
                                      "categoryL3Id": {
                                        "type": "string",
                                        "description": "Tertiary category ID",
                                        "example": "example-id"
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum SKU price (USD)",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Maximum SKU price (USD)",
                                        "example": 1
                                      },
                                      "spuAvgPrice": {
                                        "type": "number",
                                        "description": "SPU average price (USD)",
                                        "example": 1
                                      },
                                      "productRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "productCommissionRate": {
                                        "type": "number",
                                        "description": "Product commission rate",
                                        "example": 1
                                      },
                                      "totalSaleCnt": {
                                        "type": "integer",
                                        "description": "Total sales",
                                        "example": 1
                                      },
                                      "totalSale1dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 1 day",
                                        "example": 1
                                      },
                                      "totalSale7dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 7 days",
                                        "example": 1
                                      },
                                      "totalSale15dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 15 days",
                                        "example": 1
                                      },
                                      "totalSale30dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 30 days",
                                        "example": 1
                                      },
                                      "totalSale60dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 60 days",
                                        "example": 1
                                      },
                                      "totalSale90dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 90 days",
                                        "example": 1
                                      },
                                      "totalSaleGmvAmt": {
                                        "type": "number",
                                        "description": "Total GMV",
                                        "example": 1
                                      },
                                      "totalSaleGmv1dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 1 day",
                                        "example": 1
                                      },
                                      "totalSaleGmv7dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 7 days",
                                        "example": 1
                                      },
                                      "totalSaleGmv15dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 15 days",
                                        "example": 1
                                      },
                                      "totalSaleGmv30dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 30 days",
                                        "example": 1
                                      },
                                      "totalSaleGmv60dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 60 days",
                                        "example": 1
                                      },
                                      "totalSaleGmv90dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 90 days",
                                        "example": 1
                                      },
                                      "totalLiveCnt": {
                                        "type": "integer",
                                        "description": "Total livestream count",
                                        "example": 1
                                      },
                                      "totalLive1dCnt": {
                                        "type": "integer",
                                        "description": "Livestream count in last 1 day",
                                        "example": 1
                                      },
                                      "totalLive7dCnt": {
                                        "type": "integer",
                                        "description": "Livestream count in last 7 days",
                                        "example": 1
                                      },
                                      "totalLive15dCnt": {
                                        "type": "integer",
                                        "description": "Livestream count in last 15 days",
                                        "example": 1
                                      },
                                      "totalLive30dCnt": {
                                        "type": "integer",
                                        "description": "Livestream count in last 30 days",
                                        "example": 1
                                      },
                                      "totalLive60dCnt": {
                                        "type": "integer",
                                        "description": "Livestream count in last 60 days",
                                        "example": 1
                                      },
                                      "totalLive90dCnt": {
                                        "type": "integer",
                                        "description": "Livestream count in last 90 days",
                                        "example": 1
                                      },
                                      "totalLiveSale1dCnt": {
                                        "type": "integer",
                                        "description": "Livestream sales in last 1 day",
                                        "example": 1
                                      },
                                      "totalLiveSale7dCnt": {
                                        "type": "integer",
                                        "description": "Livestream sales in last 7 days",
                                        "example": 1
                                      },
                                      "totalLiveSale15dCnt": {
                                        "type": "integer",
                                        "description": "Livestream sales in last 15 days",
                                        "example": 1
                                      },
                                      "totalLiveSale30dCnt": {
                                        "type": "integer",
                                        "description": "Livestream sales in last 30 days",
                                        "example": 1
                                      },
                                      "totalLiveSale60dCnt": {
                                        "type": "integer",
                                        "description": "Livestream sales in last 60 days",
                                        "example": 1
                                      },
                                      "totalLiveSale90dCnt": {
                                        "type": "integer",
                                        "description": "Livestream sales in last 90 days",
                                        "example": 1
                                      },
                                      "totalLiveSaleGmv1dAmt": {
                                        "type": "integer",
                                        "description": "Livestream GMV in last 1 day",
                                        "example": 1
                                      },
                                      "totalLiveSaleGmv7dAmt": {
                                        "type": "integer",
                                        "description": "Livestream GMV in last 7 days",
                                        "example": 1
                                      },
                                      "totalLiveSaleGmv15dAmt": {
                                        "type": "integer",
                                        "description": "Livestream GMV in last 15 days",
                                        "example": 1
                                      },
                                      "totalLiveSaleGmv30dAmt": {
                                        "type": "integer",
                                        "description": "Livestream GMV in last 30 days",
                                        "example": 1
                                      },
                                      "totalLiveSaleGmv60dAmt": {
                                        "type": "integer",
                                        "description": "Livestream GMV in last 60 days",
                                        "example": 1
                                      },
                                      "totalLiveSaleGmv90dAmt": {
                                        "type": "integer",
                                        "description": "Livestream GMV in last 90 days",
                                        "example": 1
                                      },
                                      "totalVideoCnt": {
                                        "type": "integer",
                                        "description": "Total video count",
                                        "example": 1
                                      },
                                      "totalVideo1dCnt": {
                                        "type": "integer",
                                        "description": "Video count in last 1 day",
                                        "example": 1
                                      },
                                      "totalVideo7dCnt": {
                                        "type": "integer",
                                        "description": "Video count in last 7 days",
                                        "example": 1
                                      },
                                      "totalVideo15dCnt": {
                                        "type": "integer",
                                        "description": "Video count in last 15 days",
                                        "example": 1
                                      },
                                      "totalVideo30dCnt": {
                                        "type": "integer",
                                        "description": "Video count in last 30 days",
                                        "example": 1
                                      },
                                      "totalVideo60dCnt": {
                                        "type": "integer",
                                        "description": "Video count in last 60 days",
                                        "example": 1
                                      },
                                      "totalVideo90dCnt": {
                                        "type": "integer",
                                        "description": "Video count in last 90 days",
                                        "example": 1
                                      },
                                      "totalIflCnt": {
                                        "type": "integer",
                                        "description": "Total creator count",
                                        "example": 1
                                      },
                                      "totalIflVideo1dCnt": {
                                        "type": "integer",
                                        "description": "Creator video count in last 1 day",
                                        "example": 1
                                      },
                                      "totalIflVideo7dCnt": {
                                        "type": "integer",
                                        "description": "Creator video count in last 7 days",
                                        "example": 1
                                      },
                                      "totalIflVideo15dCnt": {
                                        "type": "integer",
                                        "description": "Creator video count in last 15 days",
                                        "example": 1
                                      },
                                      "totalIflVideo30dCnt": {
                                        "type": "integer",
                                        "description": "Creator video count in last 30 days",
                                        "example": 1
                                      },
                                      "totalIflVideo60dCnt": {
                                        "type": "integer",
                                        "description": "Creator video count in last 60 days",
                                        "example": 1
                                      },
                                      "totalIflVideo90dCnt": {
                                        "type": "integer",
                                        "description": "Creator video count in last 90 days",
                                        "example": 1
                                      },
                                      "totalIflLive1dCnt": {
                                        "type": "integer",
                                        "description": "Creator livestream count in last 1 day",
                                        "example": 1
                                      },
                                      "totalIflLive7dCnt": {
                                        "type": "integer",
                                        "description": "Creator livestream count in last 7 days",
                                        "example": 1
                                      },
                                      "totalIflLive15dCnt": {
                                        "type": "integer",
                                        "description": "Creator livestream count in last 15 days",
                                        "example": 1
                                      },
                                      "totalIflLive30dCnt": {
                                        "type": "integer",
                                        "description": "Creator livestream count in last 30 days",
                                        "example": 1
                                      },
                                      "totalIflLive60dCnt": {
                                        "type": "integer",
                                        "description": "Creator livestream count in last 60 days",
                                        "example": 1
                                      },
                                      "totalIflLive90dCnt": {
                                        "type": "integer",
                                        "description": "Creator livestream count in last 90 days",
                                        "example": 1
                                      },
                                      "totalViewsCnt": {
                                        "type": "integer",
                                        "description": "Total view count",
                                        "example": 1
                                      },
                                      "totalViews1dCnt": {
                                        "type": "integer",
                                        "description": "Views in last 1 day",
                                        "example": 1
                                      },
                                      "totalViews7dCnt": {
                                        "type": "integer",
                                        "description": "Views in last 7 days",
                                        "example": 1
                                      },
                                      "totalViews15dCnt": {
                                        "type": "integer",
                                        "description": "Views in last 15 days",
                                        "example": 1
                                      },
                                      "totalViews30dCnt": {
                                        "type": "integer",
                                        "description": "Views in last 30 days",
                                        "example": 1
                                      },
                                      "totalViews60dCnt": {
                                        "type": "integer",
                                        "description": "Views in last 60 days",
                                        "example": 1
                                      },
                                      "totalViews90dCnt": {
                                        "type": "integer",
                                        "description": "Views in last 90 days",
                                        "example": 1
                                      },
                                      "discount": {
                                        "type": "string",
                                        "description": "Discount info",
                                        "example": null
                                      },
                                      "freeShipping": {
                                        "type": "integer",
                                        "description": "Whether free shipping",
                                        "example": 1
                                      },
                                      "salesFlag": {
                                        "type": "integer",
                                        "description": "Primary shipping method",
                                        "example": 1
                                      },
                                      "salesTrendFlag": {
                                        "type": "integer",
                                        "description": "Sales trend indicator: 0=stable, 1=rising, 2=falling",
                                        "example": 1
                                      },
                                      "isSShop": {
                                        "type": "integer",
                                        "description": "Whether fully managed store",
                                        "example": 1
                                      },
                                      "offMark": {
                                        "type": "integer",
                                        "description": "Product delisting indicator",
                                        "example": 1
                                      },
                                      "firstCrawlDt": {
                                        "type": "string",
                                        "description": "First crawl date",
                                        "example": null
                                      },
                                      "descDetail": {
                                        "type": "string",
                                        "description": "Product detail description",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": "example-id",
                        "imageUrl": "https://example.com/image.jpg",
                        "productImageUrls": [],
                        "region": "US",
                        "sellerId": "example-id",
                        "categoryId": "example-id",
                        "categoryL2Id": "example-id",
                        "categoryL3Id": "example-id",
                        "minPrice": 1,
                        "maxPrice": 1,
                        "spuAvgPrice": 1,
                        "productRating": 1,
                        "reviewCount": 1,
                        "productCommissionRate": 1,
                        "totalSaleCnt": 1,
                        "totalSale1dCnt": 1,
                        "totalSale7dCnt": 1,
                        "totalSale15dCnt": 1,
                        "totalSale30dCnt": 1,
                        "totalSale60dCnt": 1,
                        "totalSale90dCnt": 1,
                        "totalSaleGmvAmt": 1,
                        "totalSaleGmv1dAmt": 1,
                        "totalSaleGmv7dAmt": 1,
                        "totalSaleGmv15dAmt": 1,
                        "totalSaleGmv30dAmt": 1,
                        "totalSaleGmv60dAmt": 1,
                        "totalSaleGmv90dAmt": 1,
                        "totalLiveCnt": 1,
                        "totalLive1dCnt": 1,
                        "totalLive7dCnt": 1,
                        "totalLive15dCnt": 1,
                        "totalLive30dCnt": 1,
                        "totalLive60dCnt": 1,
                        "totalLive90dCnt": 1,
                        "totalLiveSale1dCnt": 1,
                        "totalLiveSale7dCnt": 1,
                        "totalLiveSale15dCnt": 1,
                        "totalLiveSale30dCnt": 1,
                        "totalLiveSale60dCnt": 1,
                        "totalLiveSale90dCnt": 1,
                        "totalLiveSaleGmv1dAmt": 1,
                        "totalLiveSaleGmv7dAmt": 1,
                        "totalLiveSaleGmv15dAmt": 1,
                        "totalLiveSaleGmv30dAmt": 1,
                        "totalLiveSaleGmv60dAmt": 1,
                        "totalLiveSaleGmv90dAmt": 1,
                        "totalVideoCnt": 1,
                        "totalVideo1dCnt": 1,
                        "totalVideo7dCnt": 1,
                        "totalVideo15dCnt": 1,
                        "totalVideo30dCnt": 1,
                        "totalVideo60dCnt": 1,
                        "totalVideo90dCnt": 1,
                        "totalIflCnt": 1,
                        "totalIflVideo1dCnt": 1,
                        "totalIflVideo7dCnt": 1,
                        "totalIflVideo15dCnt": 1,
                        "totalIflVideo30dCnt": 1,
                        "totalIflVideo60dCnt": 1,
                        "totalIflVideo90dCnt": 1,
                        "totalIflLive1dCnt": 1,
                        "totalIflLive7dCnt": 1,
                        "totalIflLive15dCnt": 1,
                        "totalIflLive30dCnt": 1,
                        "totalIflLive60dCnt": 1,
                        "totalIflLive90dCnt": 1,
                        "totalViewsCnt": 1,
                        "totalViews1dCnt": 1,
                        "totalViews7dCnt": 1,
                        "totalViews15dCnt": 1,
                        "totalViews30dCnt": 1,
                        "totalViews60dCnt": 1,
                        "totalViews90dCnt": 1,
                        "freeShipping": 1,
                        "salesFlag": 1,
                        "salesTrendFlag": 1,
                        "isSShop": 1,
                        "offMark": 1
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-batch-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_batch_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-creator-analytics/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Creator Analytics",
        "description": "Search TikTok e-commerce creator leaderboards via Kalodata and query detailed profiles for specific creators. Supports viewing top-performing influencer-sellers by region, currency, language, and date range, and using creatorId to retrieve follower count, video/live revenue and GPM, contact information, and associated shops. Trigger when users mention TikTok creator search, TikTok creator ranking, TikTok influencer leaderboard, TikTok creator detail, TikTok creator profile, creator homepage data, creator contact info, TikTok creator search, TikTok creator ranking, TikTok influencer leaderboard, TikTok creator detail, creator analytics, kalodata creator search/detail. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok creator leaderboards or detailed sales performance data for a specific TikTok creator.",
        "operationId": "runTiktokCreatorAnalytics",
        "externalDocs": {
          "description": "Tiktok Creator Analytics documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-creator-analytics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "region": {
                    "type": "string",
                    "description": "Region/market code, e.g., US",
                    "example": "US"
                  },
                  "dateRange": {
                    "type": "string",
                    "description": "Time range, e.g., last7Day, last30Day",
                    "example": "last30Day"
                  },
                  "pageNumber": {
                    "type": "integer",
                    "description": "Rank requests only: page number 1-5; detail requests are unaffected. Finite numeric strings and optional null remain accepted for compatibility.",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Rank requests only: items per page 5-100; detail requests are unaffected. Finite numeric strings and optional null remain accepted for compatibility.",
                    "example": 10
                  },
                  "language": {
                    "type": "string",
                    "description": "Return language, e.g., zh-CN, en-US",
                    "example": null
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency unit, e.g., USD",
                    "example": null
                  },
                  "sortField": {
                    "type": "object",
                    "description": "Sort criteria; pass an empty object {} for default rank order when not sorting",
                    "example": {}
                  },
                  "category_ids": {
                    "type": "array",
                    "description": "Category ID list filter",
                    "example": []
                  },
                  "shop_id": {
                    "type": "string",
                    "description": "Shop ID filter",
                    "example": null
                  },
                  "revenue_range": {
                    "type": "string",
                    "description": "Revenue / GMV range filter",
                    "example": null
                  },
                  "creator_type": {
                    "type": "string",
                    "description": "Creator type filter",
                    "example": null
                  },
                  "followers_range": {
                    "type": "string",
                    "description": "Follower range filter",
                    "example": null
                  },
                  "engagement_rate": {
                    "type": "string",
                    "description": "Engagement-rate filter",
                    "example": null
                  },
                  "creatorId": {
                    "type": "string",
                    "description": "Creator unique ID, e.g., 7153432386608251946, obtainable from the creator_id in the creator rank response",
                    "example": "68616495085350913"
                  }
                },
                "required": [],
                "additionalProperties": true
              },
              "example": {
                "sortField": {},
                "dateRange": "last30Day",
                "pageSize": 10,
                "pageNumber": 1,
                "region": "US",
                "creatorId": "68616495085350913"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rank or detail data",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "creator_nickname": {
                                        "type": "string",
                                        "description": "Creator nickname",
                                        "example": null
                                      },
                                      "creator_handle": {
                                        "type": "string",
                                        "description": "TikTok profile name, e.g., @based",
                                        "example": null
                                      },
                                      "creator_id": {
                                        "type": "string",
                                        "description": "Creator unique ID, string format to avoid large integer precision loss",
                                        "example": "example-id"
                                      },
                                      "creator_followers": {
                                        "type": "string",
                                        "description": "Follower count, returned as string",
                                        "example": null
                                      },
                                      "content_views": {
                                        "type": "string",
                                        "description": "Total content views, returned as string",
                                        "example": null
                                      },
                                      "sales_volumn": {
                                        "type": "integer",
                                        "description": "Sales volume, field spelled as volumn",
                                        "example": 1
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Total revenue / GMV, returned in the requested currency",
                                        "example": 1
                                      },
                                      "video_revenue": {
                                        "type": "number",
                                        "description": "Short video sales revenue",
                                        "example": 1
                                      },
                                      "live_revenue": {
                                        "type": "number",
                                        "description": "Livestream sales revenue",
                                        "example": 1
                                      },
                                      "revenue_growth_rate": {
                                        "type": "number",
                                        "description": "Revenue growth rate (%), can be positive or negative",
                                        "example": 1
                                      },
                                      "creator_region": {
                                        "type": "string",
                                        "description": "Creator region",
                                        "example": null
                                      },
                                      "creator_status": {
                                        "type": "string",
                                        "description": "Creator status",
                                        "example": null
                                      },
                                      "creator_bio": {
                                        "type": "string",
                                        "description": "Creator bio",
                                        "example": null
                                      },
                                      "creator_belonged_shop_id": {
                                        "type": "string",
                                        "description": "Belonged shop ID",
                                        "example": "example-id"
                                      },
                                      "new_followers": {
                                        "type": "integer",
                                        "description": "New followers within the dateRange window",
                                        "example": 1
                                      },
                                      "unit_price": {
                                        "type": "number",
                                        "description": "Unit price",
                                        "example": 1
                                      },
                                      "video_number": {
                                        "type": "integer",
                                        "description": "Video count within the window",
                                        "example": 1
                                      },
                                      "video_views": {
                                        "type": "integer",
                                        "description": "Total video views",
                                        "example": 1
                                      },
                                      "video_gpm": {
                                        "type": "number",
                                        "description": "Video GPM",
                                        "example": 1
                                      },
                                      "live_number": {
                                        "type": "integer",
                                        "description": "Livestream count within the window",
                                        "example": 1
                                      },
                                      "live_views": {
                                        "type": "integer",
                                        "description": "Total livestream views",
                                        "example": 1
                                      },
                                      "live_gpm": {
                                        "type": "number",
                                        "description": "Livestream GPM",
                                        "example": 1
                                      },
                                      "product_number": {
                                        "type": "integer",
                                        "description": "Associated product count",
                                        "example": 1
                                      },
                                      "shop_number": {
                                        "type": "integer",
                                        "description": "Associated shop count",
                                        "example": 1
                                      },
                                      "creator_contact_email": {
                                        "type": "string",
                                        "description": "Contact email",
                                        "example": null
                                      },
                                      "creator_contact_ins": {
                                        "type": "string",
                                        "description": "Instagram contact",
                                        "example": null
                                      },
                                      "creator_contact_whatsapp": {
                                        "type": "string",
                                        "description": "WhatsApp contact",
                                        "example": null
                                      },
                                      "creator_contact_facebook": {
                                        "type": "string",
                                        "description": "Facebook contact",
                                        "example": null
                                      },
                                      "creator_contact_tiktok": {
                                        "type": "string",
                                        "description": "TikTok contact",
                                        "example": null
                                      },
                                      "creator_contact_zalo": {
                                        "type": "string",
                                        "description": "Zalo contact",
                                        "example": null
                                      },
                                      "creator_contact_line": {
                                        "type": "string",
                                        "description": "Line contact",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed for this call, typically 14000",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": [
                      {
                        "creator_id": "example-id",
                        "sales_volumn": 1,
                        "revenue": 1,
                        "video_revenue": 1,
                        "live_revenue": 1,
                        "revenue_growth_rate": 1,
                        "creator_belonged_shop_id": "example-id",
                        "new_followers": 1,
                        "unit_price": 1,
                        "video_number": 1,
                        "video_views": 1,
                        "video_gpm": 1,
                        "live_number": 1,
                        "live_views": 1,
                        "live_gpm": 1,
                        "product_number": 1,
                        "shop_number": 1
                      }
                    ],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-creator-analytics",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_creator_analytics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-creator-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Creator Rankings",
        "description": "Queries creator rankings by region and date range.",
        "operationId": "runTiktokCreatorSearch",
        "externalDocs": {
          "description": "TikTok Creator Search documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-creator-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "region": {
                    "type": "string",
                    "description": "Optional TikTok Shop market region.",
                    "example": "US"
                  },
                  "dateRange": {
                    "type": "string",
                    "description": "Relative date range.",
                    "example": "last30Day"
                  },
                  "pageNumber": {
                    "type": "integer",
                    "description": "Page number, 1-5. Finite numeric strings and optional null remain accepted by the backend for compatibility.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 5,
                    "x-nexscope-constraints": {
                      "minimum": 1,
                      "maximum": 5
                    }
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Rows per page, 5-100. Finite numeric strings and optional null remain accepted by the backend for compatibility.",
                    "example": 10,
                    "minimum": 5,
                    "maximum": 100,
                    "x-nexscope-constraints": {
                      "minimum": 5,
                      "maximum": 100
                    }
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency code.",
                    "example": "USD"
                  },
                  "language": {
                    "type": "string",
                    "description": "Response language.",
                    "example": "en-US"
                  },
                  "sortField": {
                    "type": "object",
                    "description": "Optional provider sort object.",
                    "example": {}
                  }
                },
                "required": [],
                "additionalProperties": true
              },
              "example": {
                "dateRange": "last30Day",
                "region": "US",
                "pageSize": 10,
                "pageNumber": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Creator ranking rows.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "creator_id": {
                                        "type": "string",
                                        "description": "TikTok creator ID.",
                                        "example": "68616495085350913"
                                      },
                                      "creator_nickname": {
                                        "type": "string",
                                        "description": "Creator nickname.",
                                        "example": "Example creator"
                                      },
                                      "creator_handle": {
                                        "type": "string",
                                        "description": "TikTok handle.",
                                        "example": "@creator"
                                      },
                                      "creator_followers": {
                                        "type": "string",
                                        "description": "Follower count returned as a string.",
                                        "example": "100000"
                                      },
                                      "content_views": {
                                        "type": "string",
                                        "description": "Content views returned as a string.",
                                        "example": "1000000"
                                      },
                                      "sales_volumn": {
                                        "type": "integer",
                                        "description": "Estimated sales volume (provider spelling).",
                                        "example": 100
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Estimated creator GMV.",
                                        "example": 1000
                                      },
                                      "video_revenue": {
                                        "type": "number",
                                        "description": "Short-video revenue.",
                                        "example": 600
                                      },
                                      "live_revenue": {
                                        "type": "number",
                                        "description": "Livestream revenue.",
                                        "example": 400
                                      },
                                      "revenue_growth_rate": {
                                        "type": "number",
                                        "description": "Revenue growth percentage.",
                                        "example": 12.5
                                      },
                                      "creator_region": {
                                        "type": "string",
                                        "description": "Creator region.",
                                        "example": "US"
                                      },
                                      "creator_status": {
                                        "type": "string",
                                        "description": "Creator status.",
                                        "example": "active"
                                      },
                                      "new_followers": {
                                        "type": "integer",
                                        "description": "New followers in the selected window.",
                                        "example": 1000
                                      },
                                      "video_number": {
                                        "type": "integer",
                                        "description": "Video count.",
                                        "example": 20
                                      },
                                      "live_number": {
                                        "type": "integer",
                                        "description": "Livestream count.",
                                        "example": 5
                                      },
                                      "product_number": {
                                        "type": "integer",
                                        "description": "Associated product count.",
                                        "example": 10
                                      },
                                      "shop_number": {
                                        "type": "integer",
                                        "description": "Associated shop count.",
                                        "example": 3
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": [
                      {
                        "creator_id": "68616495085350913",
                        "creator_nickname": "Example creator",
                        "creator_handle": "@creator",
                        "creator_followers": "100000",
                        "content_views": "1000000",
                        "sales_volumn": 100,
                        "revenue": 1000,
                        "video_revenue": 600,
                        "live_revenue": 400,
                        "revenue_growth_rate": 12.5,
                        "creator_region": "US",
                        "creator_status": "active",
                        "new_followers": 1000,
                        "video_number": 20,
                        "live_number": 5,
                        "product_number": 10,
                        "shop_number": 3
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-creator-search",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_creator_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-livestream-analytics/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Livestream Analytics",
        "description": "Search TikTok e-commerce livestream leaderboards via Kalodata and query detailed data for specific livestreams. Supports viewing high-ranking, high-sales TikTok shopping livestreams by region, currency, language, and date range, and using livestreamId to retrieve revenue, viewers, duration, GPM, and number of products sold. Trigger when users mention TikTok livestream ranking, TikTok live ranking, TikTok top livestreams, TikTok live shopping ranking, TikTok livestream detail, TikTok live data, live viewers, kalodata livestream search, kalodata livestream ranking, TikTok livestream ranking, TikTok live ranking, TikTok top livestreams, TikTok live shopping ranking, TikTok livestream detail, kalodata livestream search/detail, live analytics. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok livestream leaderboards or detailed data for a specific TikTok livestream.",
        "operationId": "runTiktokLivestreamAnalytics",
        "externalDocs": {
          "description": "Tiktok Livestream Analytics documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-livestream-analytics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-livestream-analytics.",
                "properties": {
                  "region": {
                    "type": "string",
                    "description": "Region/market code, e.g., US. Max length 1000",
                    "example": "US"
                  },
                  "dateRange": {
                    "type": "string",
                    "description": "Time range, e.g., last7Day (last 7 days), last30Day (last 30 days). Max length 1000",
                    "example": "last30Day"
                  },
                  "pageNumber": {
                    "type": "integer",
                    "description": "Page number, value range 1-5 (out of range returns errcode 501)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, value range 5-100",
                    "example": 10
                  },
                  "language": {
                    "type": "string",
                    "description": "Return language, e.g., zh-CN, en-US. Max length 1000"
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency unit, e.g., USD. Max length 1000"
                  },
                  "sortField": {
                    "type": "object",
                    "description": "Sort criteria, structure defined by the gateway; pass an empty object {} for default rank order when not sorting",
                    "example": {},
                    "properties": {},
                    "additionalProperties": true
                  },
                  "livestreamId": {
                    "type": "string",
                    "description": "Target livestream unique ID (camelCase), e.g., 7661409374878878494. Typically obtained from the livestream_id in the livestream rank endpoint. Max length 1000"
                  },
                  "category_id": {
                    "type": "string",
                    "description": "Category ID filter"
                  },
                  "shop_id": {
                    "type": "string",
                    "description": "Shop ID filter"
                  },
                  "creator_id": {
                    "type": "string",
                    "description": "Creator ID filter"
                  },
                  "product_id": {
                    "type": "string",
                    "description": "Product ID filter"
                  },
                  "followers_range": {
                    "type": "string",
                    "description": "Creator follower range filter"
                  }
                },
                "example": {
                  "pageNumber": 1,
                  "sortField": {},
                  "region": "US",
                  "pageSize": 10,
                  "dateRange": "last30Day"
                },
                "additionalProperties": true
              },
              "example": {
                "pageNumber": 1,
                "sortField": {},
                "region": "US",
                "pageSize": 10,
                "dateRange": "last30Day"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Livestream rank list or livestream detail data",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "livestream_start_time": {
                                        "type": "integer",
                                        "description": "Livestream start time (epoch milliseconds)",
                                        "example": 1
                                      },
                                      "livestream_end_time": {
                                        "type": "integer",
                                        "description": "Livestream end time (epoch milliseconds)",
                                        "example": 1
                                      },
                                      "livestream_duration": {
                                        "type": "integer",
                                        "description": "Livestream duration (seconds)",
                                        "example": 1
                                      },
                                      "livestream_title": {
                                        "type": "string",
                                        "description": "Livestream title",
                                        "example": null
                                      },
                                      "livestream_id": {
                                        "type": "string",
                                        "description": "Livestream unique ID (string, to avoid large integer precision loss); can be used as livestreamId in the detail endpoint",
                                        "example": "example-id"
                                      },
                                      "creator_id": {
                                        "type": "string",
                                        "description": "Creator unique ID (string, to avoid large integer precision loss)",
                                        "example": "example-id"
                                      },
                                      "creator_handle": {
                                        "type": "string",
                                        "description": "Creator account handle",
                                        "example": null
                                      },
                                      "revenue": {
                                        "type": "string",
                                        "description": "Total revenue / GMV (in the requested currency; returned as string, e.g., \"185590.52\")",
                                        "example": null
                                      },
                                      "unit_price": {
                                        "type": "string",
                                        "description": "Unit price (in the requested currency; returned as string, e.g., \"265.89\")",
                                        "example": null
                                      },
                                      "views": {
                                        "type": "integer",
                                        "description": "View count",
                                        "example": 1
                                      },
                                      "record_type": {
                                        "type": "string",
                                        "description": "Record type (e.g., SHORT)",
                                        "example": null
                                      },
                                      "viewers": {
                                        "type": "integer",
                                        "description": "Viewer count (note: DETAIL uses viewers, RANK uses views)",
                                        "example": 1
                                      },
                                      "gpm": {
                                        "type": "number",
                                        "description": "GMV per mille, number type -- unique to DETAIL, not present in the RANK endpoint",
                                        "example": 1
                                      },
                                      "product_number": {
                                        "type": "integer",
                                        "description": "Product count in the livestream",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed for this call, fixed at 14000",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": [
                      {
                        "livestream_start_time": 1,
                        "livestream_end_time": 1,
                        "livestream_duration": 1,
                        "livestream_id": "example-id",
                        "creator_id": "example-id",
                        "views": 1,
                        "viewers": 1,
                        "gpm": 1,
                        "product_number": 1
                      }
                    ],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-livestream-analytics",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_livestream_analytics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-new-product-rank/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok New Product Rank",
        "description": "Discover trending new products across 16 TikTok Shop regional markets via Nexscope new product ranking data. Trigger when users mention TikTok new product rankings, TikTok hot-selling products, TikTok Shop bestsellers, short-video e-commerce product selection, TikTok new product discovery, cross-border TikTok product selection, TikTok new product rankings, TikTok bestsellers, short-video product selection, TikTok viral products, new product ranking, TikTok product trends. Even if the user does not explicitly mention \"Nexscope\" or \"new product ranking\", trigger this skill whenever their need involves discovering hot-selling new products or emerging product trends on TikTok Shop.",
        "operationId": "runTiktokNewProductRank",
        "externalDocs": {
          "description": "Tiktok New Product Rank documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-new-product-rank"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-new-product-rank.",
                "properties": {
                  "date": {
                    "type": "string",
                    "description": "Date in YYYY-MM-DD format",
                    "example": "2026-08-01"
                  },
                  "region": {
                    "type": "string",
                    "description": "Region, default US. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)",
                    "example": "US"
                  },
                  "pageNum": {
                    "type": "integer",
                    "description": "Page number, default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, default 50",
                    "example": 10
                  }
                },
                "required": [
                  "date"
                ],
                "example": {
                  "pageNum": 1,
                  "date": "2026-08-01",
                  "region": "US",
                  "pageSize": 10
                },
                "additionalProperties": true
              },
              "example": {
                "pageNum": 1,
                "date": "2026-08-01",
                "region": "US",
                "pageSize": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "New product list (see product object below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "title": {
                                        "type": "string",
                                        "description": "Product name",
                                        "example": null
                                      },
                                      "asin": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "B072MQ5BRX"
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Region code",
                                        "example": "US"
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "SPU average price",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum price",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Maximum price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "totalSaleCnt": {
                                        "type": "integer",
                                        "description": "Total sales",
                                        "example": 1
                                      },
                                      "totalSale30dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 30 days",
                                        "example": 1
                                      },
                                      "totalSaleGmvAmt": {
                                        "type": "number",
                                        "description": "Total GMV",
                                        "example": 1
                                      },
                                      "totalSaleGmv30dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 30 days",
                                        "example": 1
                                      },
                                      "salesTrendFlagText": {
                                        "type": "string",
                                        "description": "Sales trend indicator, 0=stable 1=rising 2=falling",
                                        "example": null
                                      },
                                      "totalVideoCnt": {
                                        "type": "integer",
                                        "description": "Total video count",
                                        "example": 1
                                      },
                                      "totalLiveCnt": {
                                        "type": "integer",
                                        "description": "Total livestream count",
                                        "example": 1
                                      },
                                      "totalIflCnt": {
                                        "type": "integer",
                                        "description": "Total creator count",
                                        "example": 1
                                      },
                                      "productCommissionRate": {
                                        "type": "number",
                                        "description": "Product commission rate",
                                        "example": 1
                                      },
                                      "productRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "First crawl date",
                                        "example": "2026-01-01"
                                      },
                                      "categoryId": {
                                        "type": "string",
                                        "description": "Product category ID",
                                        "example": "example-id"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Product image URL list",
                                        "example": []
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Product source",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "asin": "B072MQ5BRX",
                        "region": "US",
                        "price": 1,
                        "minPrice": 1,
                        "maxPrice": 1,
                        "totalSaleCnt": 1,
                        "totalSale30dCnt": 1,
                        "totalSaleGmvAmt": 1,
                        "totalSaleGmv30dAmt": 1,
                        "totalVideoCnt": 1,
                        "totalLiveCnt": 1,
                        "totalIflCnt": 1,
                        "productCommissionRate": 1,
                        "productRating": 1,
                        "reviewCount": 1,
                        "availableDate": "2026-01-01",
                        "categoryId": "example-id",
                        "imageUrl": "https://example.com/image.jpg",
                        "productImageUrls": []
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-new-product-rank",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_new_product_rank",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-product-analytics/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Product Analytics",
        "description": "Query TikTok e-commerce product leaderboards via Kalodata and query detailed data for specific products. Supports viewing high-ranking/hot-selling products by region, currency, language, and date range, and using productId to retrieve price range, sales, revenue, commission rate, listing/delisting time, and owning shop. Trigger when users mention TikTok product ranking, TikTok bestseller chart, TikTok top products, kalodata product rank, TikTok product detail, TikTok product profile, product price, product sales, TikTok product ranking, TikTok bestseller chart, TikTok top products, kalodata product rank, TikTok product detail, kalodata product detail, product analytics. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok product leaderboards or detailed data for a specific TikTok product.",
        "operationId": "runTiktokProductAnalytics",
        "externalDocs": {
          "description": "Tiktok Product Analytics documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-product-analytics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-product-analytics.",
                "properties": {
                  "region": {
                    "type": "string",
                    "description": "TikTok Shop market region code, e.g., US. If not specified, defaults to the server default (usually US)",
                    "example": "US"
                  },
                  "dateRange": {
                    "type": "string",
                    "description": "Relative date range, e.g., last7Day, last30Day",
                    "example": "last30Day"
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency code, e.g., USD"
                  },
                  "language": {
                    "type": "string",
                    "description": "Return language, e.g., zh-CN, en-US"
                  },
                  "sortField": {
                    "type": "object",
                    "description": "Sort specification object; omitted to use default ranking",
                    "example": {},
                    "properties": {},
                    "additionalProperties": true
                  },
                  "pageNumber": {
                    "type": "integer",
                    "description": "Page number, range 1-5",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, range 5-100",
                    "example": 10
                  },
                  "productId": {
                    "type": "string",
                    "description": "TikTok product ID, e.g., 1729508370969629931 (string format, to avoid large integer precision loss), obtainable from the product_id in the product rank response",
                    "example": "1732505564636812173"
                  },
                  "category_ids": {
                    "type": "array",
                    "description": "Category ID list filter",
                    "example": []
                  },
                  "shop_id": {
                    "type": "string",
                    "description": "Shop ID filter"
                  },
                  "creator_id": {
                    "type": "string",
                    "description": "Creator ID filter"
                  },
                  "video_id": {
                    "type": "string",
                    "description": "Return products associated with the specified video"
                  },
                  "livestream_id": {
                    "type": "string",
                    "description": "Return products associated with the specified livestream"
                  },
                  "revenue_range": {
                    "type": "string",
                    "description": "Revenue / GMV range filter"
                  },
                  "is_affiliate": {
                    "type": "string",
                    "description": "Affiliate filter: PUBLIC_PLAN or NON_AFFILIATE"
                  },
                  "commission_rate": {
                    "type": "number",
                    "description": "Affiliate commission rate, e.g. 0.15"
                  },
                  "is_tts_product": {
                    "type": "integer",
                    "description": "Fully managed product filter: 1 or 0"
                  },
                  "unit_price_range": {
                    "type": "string",
                    "description": "Product unit-price range filter"
                  }
                },
                "example": {
                  "sortField": {},
                  "dateRange": "last30Day",
                  "pageSize": 10,
                  "productId": "1732505564636812173",
                  "pageNumber": 1,
                  "region": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "sortField": {},
                "dateRange": "last30Day",
                "pageSize": 10,
                "productId": "1732505564636812173",
                "pageNumber": 1,
                "region": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rank or detail data",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "product_id": {
                                        "type": "string",
                                        "description": "Product ID (string format, to avoid large integer precision loss); used as productId to query details",
                                        "example": "example-id"
                                      },
                                      "product_name": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "unit_price": {
                                        "type": "number",
                                        "description": "Unit price (currency depends on region, e.g., US means USD)",
                                        "example": 1
                                      },
                                      "sales_volumn": {
                                        "type": "integer",
                                        "description": "Sales volume (units). Note: the field name is spelled sales_volumn (as-is, not volume). Use this exact name when extracting with jq/ConvertFrom-Json",
                                        "example": 1
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Total revenue (GMV), = video_revenue + live_revenue + showcase_revenue",
                                        "example": 1
                                      },
                                      "video_revenue": {
                                        "type": "number",
                                        "description": "Video channel revenue",
                                        "example": 1
                                      },
                                      "live_revenue": {
                                        "type": "number",
                                        "description": "Livestream channel revenue",
                                        "example": 1
                                      },
                                      "showcase_revenue": {
                                        "type": "number",
                                        "description": "Showcase/display channel revenue",
                                        "example": 1
                                      },
                                      "revenue_growth_rate": {
                                        "type": "number",
                                        "description": "Revenue growth rate (percentage, e.g., 27.94 means 27.94%)",
                                        "example": 1
                                      },
                                      "commission_rate": {
                                        "type": "number",
                                        "description": "Commission rate (percentage, e.g., 25.0 means 25%; not basis points)",
                                        "example": 1
                                      },
                                      "launch_date": {
                                        "type": "string",
                                        "description": "Launch date (YYYY-MM-DD)",
                                        "example": "2026-01-01"
                                      },
                                      "product_region": {
                                        "type": "string",
                                        "description": "Product region/market (e.g., us)",
                                        "example": null
                                      },
                                      "product_shop_id": {
                                        "type": "string",
                                        "description": "Belonged shop ID",
                                        "example": "example-id"
                                      },
                                      "pri_cate_id": {
                                        "type": "string",
                                        "description": "Primary category ID",
                                        "example": "example-id"
                                      },
                                      "sec_cate_id": {
                                        "type": "string",
                                        "description": "Secondary category ID",
                                        "example": "example-id"
                                      },
                                      "ter_cate_id": {
                                        "type": "string",
                                        "description": "Tertiary category ID",
                                        "example": "example-id"
                                      },
                                      "min_price": {
                                        "type": "number",
                                        "description": "Minimum price (in the requested currency)",
                                        "example": 1
                                      },
                                      "max_price": {
                                        "type": "number",
                                        "description": "Maximum price (in the requested currency)",
                                        "example": 1
                                      },
                                      "product_review_count": {
                                        "type": "integer",
                                        "description": "Product review count",
                                        "example": 1
                                      },
                                      "delivery_type": {
                                        "type": "string",
                                        "description": "Delivery method (e.g., local)",
                                        "example": null
                                      },
                                      "video_number": {
                                        "type": "integer",
                                        "description": "Associated video count",
                                        "example": 1
                                      },
                                      "live_number": {
                                        "type": "integer",
                                        "description": "Associated livestream count",
                                        "example": 1
                                      },
                                      "shopping_mall_revenue": {
                                        "type": "number",
                                        "description": "Mall revenue (in the requested currency)",
                                        "example": 1
                                      },
                                      "creator_number": {
                                        "type": "integer",
                                        "description": "Associated creator count",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed for this call, typically 14000",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": [
                      {
                        "product_id": "example-id",
                        "unit_price": 1,
                        "sales_volumn": 1,
                        "revenue": 1,
                        "video_revenue": 1,
                        "live_revenue": 1,
                        "showcase_revenue": 1,
                        "revenue_growth_rate": 1,
                        "commission_rate": 1,
                        "launch_date": "2026-01-01",
                        "product_shop_id": "example-id",
                        "pri_cate_id": "example-id",
                        "sec_cate_id": "example-id",
                        "ter_cate_id": "example-id",
                        "min_price": 1,
                        "max_price": 1,
                        "product_review_count": 1,
                        "video_number": 1,
                        "live_number": 1,
                        "shopping_mall_revenue": 1,
                        "creator_number": 1
                      }
                    ],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-product-analytics",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_product_analytics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-product-analytics-api/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Product Analytics API",
        "description": "Queries Kalodata product details, including price, sales, revenue, commission, lifecycle, and shop data.",
        "operationId": "runTiktokProductAnalyticsApi",
        "externalDocs": {
          "description": "TikTok Product Analytics API documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-product-analytics-api"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Kalodata product-detail query.",
                "properties": {
                  "productId": {
                    "type": "string",
                    "description": "TikTok product ID.",
                    "example": "1732505564636812173"
                  },
                  "region": {
                    "type": "string",
                    "description": "TikTok Shop market region.",
                    "example": "US"
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency code.",
                    "example": "USD"
                  },
                  "language": {
                    "type": "string",
                    "description": "Response language.",
                    "example": "en-US"
                  }
                },
                "required": [
                  "productId"
                ],
                "example": {
                  "productId": "1732505564636812173",
                  "region": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "productId": "1732505564636812173",
                "region": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product-detail data.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "product_id": {
                                        "type": "string",
                                        "description": "TikTok product ID.",
                                        "example": "1732505564636812173"
                                      },
                                      "product_name": {
                                        "type": "string",
                                        "description": "Product name.",
                                        "example": "Example product"
                                      },
                                      "unit_price": {
                                        "type": "number",
                                        "description": "Current unit price.",
                                        "example": 12.99
                                      },
                                      "sales_volumn": {
                                        "type": "integer",
                                        "description": "Estimated sales volume (provider spelling).",
                                        "example": 100
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Total revenue / GMV.",
                                        "example": 1000
                                      },
                                      "video_revenue": {
                                        "type": "number",
                                        "description": "Video-channel revenue.",
                                        "example": 600
                                      },
                                      "live_revenue": {
                                        "type": "number",
                                        "description": "Livestream revenue.",
                                        "example": 300
                                      },
                                      "showcase_revenue": {
                                        "type": "number",
                                        "description": "Showcase revenue.",
                                        "example": 100
                                      },
                                      "revenue_growth_rate": {
                                        "type": "number",
                                        "description": "Revenue growth percentage.",
                                        "example": 12.5
                                      },
                                      "commission_rate": {
                                        "type": "number",
                                        "description": "Commission percentage.",
                                        "example": 20
                                      },
                                      "launch_date": {
                                        "type": "string",
                                        "description": "Product launch date.",
                                        "example": "2026-01-01"
                                      },
                                      "product_region": {
                                        "type": "string",
                                        "description": "Product market region.",
                                        "example": "US"
                                      },
                                      "product_shop_id": {
                                        "type": "string",
                                        "description": "Owning shop ID.",
                                        "example": "shop-id"
                                      },
                                      "min_price": {
                                        "type": "number",
                                        "description": "Minimum product price.",
                                        "example": 9.99
                                      },
                                      "max_price": {
                                        "type": "number",
                                        "description": "Maximum product price.",
                                        "example": 19.99
                                      },
                                      "product_review_count": {
                                        "type": "integer",
                                        "description": "Review count.",
                                        "example": 200
                                      },
                                      "video_number": {
                                        "type": "integer",
                                        "description": "Associated video count.",
                                        "example": 25
                                      },
                                      "live_number": {
                                        "type": "integer",
                                        "description": "Associated livestream count.",
                                        "example": 5
                                      },
                                      "creator_number": {
                                        "type": "integer",
                                        "description": "Associated creator count.",
                                        "example": 10
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": [
                      {
                        "product_id": "1732505564636812173",
                        "product_name": "Example product",
                        "unit_price": 12.99,
                        "sales_volumn": 100,
                        "revenue": 1000,
                        "video_revenue": 600,
                        "live_revenue": 300,
                        "showcase_revenue": 100,
                        "revenue_growth_rate": 12.5,
                        "commission_rate": 20,
                        "launch_date": "2026-01-01",
                        "product_region": "US",
                        "product_shop_id": "shop-id",
                        "min_price": 9.99,
                        "max_price": 19.99,
                        "product_review_count": 200,
                        "video_number": 25,
                        "live_number": 5,
                        "creator_number": 10
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-product-analytics-api",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_product_analytics_api",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-product-discovery/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Product Discovery",
        "description": "Search and filter TikTok global e-commerce products based on FastMoss data, supporting keyword search, multi-dimensional filtering (category, shop type, commission rate, sales, creator count, etc.) and sorting. Trigger when users mention TikTok product selection, TikTok product search, TikTok product data, TikTok creator sales, TikTok commission rate, TikTok bestseller tracking, TikTok GMV analysis, TikTok product search, TikTok product research, TikTok creator sales, TikTok commission rate, TikTok GMV analysis, FastMoss. Even if the user does not explicitly mention \"FastMoss\", trigger this skill whenever their need involves searching product data or analyzing product performance on TikTok.",
        "operationId": "runTiktokProductDiscovery",
        "externalDocs": {
          "description": "Tiktok Product Discovery documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-product-discovery"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-product-discovery.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Search keyword (fuzzy match on product title)",
                    "example": "phone case"
                  },
                  "region": {
                    "type": "string",
                    "description": "Market region code. Options: US (United States), GB (United Kingdom), MX (Mexico), ES (Spain), DE (Germany), IT (Italy), FR (France), ID (Indonesia), VN (Vietnam), MY (Malaysia), TH (Thailand), PH (Philippines), BR (Brazil), JP (Japan), SG (Singapore)",
                    "example": "US"
                  },
                  "category": {
                    "type": "string",
                    "description": "English category name, automatically matched to TikTok category ID. Non-English input must be translated to English first"
                  },
                  "shopType": {
                    "type": "integer",
                    "description": "Store type: 1=local store, 2=cross-border store",
                    "example": 1
                  },
                  "isTopSelling": {
                    "type": "boolean",
                    "description": "Filter hot-selling products only",
                    "example": false
                  },
                  "isNewListed": {
                    "type": "boolean",
                    "description": "Filter newly listed products only",
                    "example": false
                  },
                  "isSshop": {
                    "type": "boolean",
                    "description": "Filter TikTok fully managed (S-shop) products only",
                    "example": false
                  },
                  "isFreeShipping": {
                    "type": "boolean",
                    "description": "Filter free shipping products only",
                    "example": false
                  },
                  "isLocalWarehouse": {
                    "type": "boolean",
                    "description": "Filter local warehouse shipping products only",
                    "example": false
                  },
                  "unitsSoldRange": {
                    "type": "object",
                    "description": "Sales volume range filter, format: {\"min\": 100, \"max\": 5000}",
                    "example": {},
                    "properties": {},
                    "additionalProperties": true
                  },
                  "commissionRateRange": {
                    "type": "object",
                    "description": "Commission rate range filter, format: {\"min\": 0.05, \"max\": 0.20} (decimal, 0.10=10%)",
                    "example": {},
                    "properties": {},
                    "additionalProperties": true
                  },
                  "creatorCountRange": {
                    "type": "object",
                    "description": "Creator count range filter, format: {\"min\": 10, \"max\": 500}",
                    "example": {},
                    "properties": {},
                    "additionalProperties": true
                  },
                  "orderField": {
                    "type": "string",
                    "description": "Sort field: day7_units_sold (7-day sales), day7_gmv (7-day GMV), commission_rate (commission rate), total_units_sold (total sales), total_gmv (total GMV), creator_count (creator count). Default descending order"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, max 10, default 10",
                    "example": 10
                  },
                  "pageNumber": {
                    "type": "integer"
                  }
                },
                "example": {
                  "region": "US",
                  "pageSize": 10,
                  "keyword": "phone case",
                  "pageNumber": 1
                },
                "additionalProperties": true
              },
              "example": {
                "region": "US",
                "pageSize": 10,
                "keyword": "phone case",
                "pageNumber": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matching records",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product information list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "title": {
                                        "type": "string",
                                        "description": "Product title",
                                        "example": null
                                      },
                                      "productId": {
                                        "type": "string",
                                        "description": "Product unique identifier ID",
                                        "example": "example-id"
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Market region code",
                                        "example": "US"
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Product price",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum price",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Maximum price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency code",
                                        "example": null
                                      },
                                      "totalSaleCnt": {
                                        "type": "integer",
                                        "description": "Cumulative total sales",
                                        "example": 1
                                      },
                                      "totalSale1dCnt": {
                                        "type": "integer",
                                        "description": "1-day sales",
                                        "example": 1
                                      },
                                      "totalSale7dCnt": {
                                        "type": "integer",
                                        "description": "7-day sales",
                                        "example": 1
                                      },
                                      "totalSale28dCnt": {
                                        "type": "integer",
                                        "description": "28-day sales",
                                        "example": 1
                                      },
                                      "totalSale90dCnt": {
                                        "type": "integer",
                                        "description": "90-day sales",
                                        "example": 1
                                      },
                                      "totalSaleGmvAmt": {
                                        "type": "number",
                                        "description": "Cumulative total GMV",
                                        "example": 1
                                      },
                                      "totalSaleGmv7dAmt": {
                                        "type": "number",
                                        "description": "7-day GMV",
                                        "example": 1
                                      },
                                      "totalSaleGmv28dAmt": {
                                        "type": "number",
                                        "description": "28-day GMV",
                                        "example": 1
                                      },
                                      "totalVideoCnt": {
                                        "type": "integer",
                                        "description": "Number of promotional videos",
                                        "example": 1
                                      },
                                      "totalLiveCnt": {
                                        "type": "integer",
                                        "description": "Number of livestream promotions",
                                        "example": 1
                                      },
                                      "totalIflCnt": {
                                        "type": "integer",
                                        "description": "Number of promoting creators",
                                        "example": 1
                                      },
                                      "productCommissionRate": {
                                        "type": "number",
                                        "description": "Product commission rate (decimal, 0.10=10%)",
                                        "example": 1
                                      },
                                      "productRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "skuCount": {
                                        "type": "integer",
                                        "description": "SKU count",
                                        "example": 1
                                      },
                                      "shopName": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "shopSellerId": {
                                        "type": "string",
                                        "description": "Seller ID",
                                        "example": "example-id"
                                      },
                                      "shopTotalUnitsSold": {
                                        "type": "integer",
                                        "description": "Store total sales",
                                        "example": 1
                                      },
                                      "isCrossBorder": {
                                        "type": "integer",
                                        "description": "Whether cross-border: 1=cross-border, 0=local",
                                        "example": 1
                                      },
                                      "isSShopText": {
                                        "type": "string",
                                        "description": "Whether a fully managed store (Yes/No)",
                                        "example": null
                                      },
                                      "freeShippingText": {
                                        "type": "string",
                                        "description": "Whether free shipping (Yes/No)",
                                        "example": null
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time",
                                        "example": "2026-01-01"
                                      },
                                      "categoryName": {
                                        "type": "string",
                                        "description": "Product category name",
                                        "example": null
                                      },
                                      "salesTrendFlagText": {
                                        "type": "string",
                                        "description": "Sales trend indicator",
                                        "example": null
                                      },
                                      "tiktokUrl": {
                                        "type": "string",
                                        "description": "TikTok product link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "fastmossUrl": {
                                        "type": "string",
                                        "description": "FastMoss product detail link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL",
                                        "example": "https://example.com/image.jpg"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style type",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": "example-id",
                        "region": "US",
                        "price": 1,
                        "minPrice": 1,
                        "maxPrice": 1,
                        "totalSaleCnt": 1,
                        "totalSale1dCnt": 1,
                        "totalSale7dCnt": 1,
                        "totalSale28dCnt": 1,
                        "totalSale90dCnt": 1,
                        "totalSaleGmvAmt": 1,
                        "totalSaleGmv7dAmt": 1,
                        "totalSaleGmv28dAmt": 1,
                        "totalVideoCnt": 1,
                        "totalLiveCnt": 1,
                        "totalIflCnt": 1,
                        "productCommissionRate": 1,
                        "productRating": 1,
                        "reviewCount": 1,
                        "skuCount": 1,
                        "shopSellerId": "example-id",
                        "shopTotalUnitsSold": 1,
                        "isCrossBorder": 1,
                        "availableDate": "2026-01-01",
                        "tiktokUrl": "https://example.com/image.jpg",
                        "fastmossUrl": "https://example.com/image.jpg",
                        "imageUrl": "https://example.com/image.jpg"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-product-discovery",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_product_discovery",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-product-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Product Search",
        "description": "Search and analyze TikTok product data including sales, influencer sales data, pricing, and commission rates across 16 TikTok Shop sites. Trigger when users mention TikTok product search, TikTok Shop product analysis, TikTok sales data, influencer sales, TikTok product selection, TikTok commission rate, TikTok product ranking, Nexscope data query, TikTok product search, TikTok sales, influencer sales, TikTok commission, TikTok product selection, short-video e-commerce, TikTok data. Even if the user does not explicitly mention \"Nexscope\" or \"TikTok\", trigger this skill whenever their need involves searching products on TikTok Shop or analyzing TikTok product performance metrics.",
        "operationId": "runTiktokProductSearch",
        "externalDocs": {
          "description": "Tiktok Product Search documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-product-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-product-search.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Product keyword (please translate to the local language). Max length 1000",
                    "example": "phone case"
                  },
                  "region": {
                    "type": "string",
                    "description": "Region, default US. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)",
                    "example": "US"
                  },
                  "categoryKeywordCN": {
                    "type": "string",
                    "description": "Product category (please enter in Chinese). Max length 1000",
                    "example": "phone case"
                  },
                  "minTotalSaleCnt": {
                    "type": "integer",
                    "description": "Total sales (minimum)",
                    "example": 1
                  },
                  "maxTotalSaleCnt": {
                    "type": "integer",
                    "description": "Total sales (maximum)",
                    "example": 1
                  },
                  "minTotalSale30dCnt": {
                    "type": "integer",
                    "description": "30-day sales (minimum)",
                    "example": 1
                  },
                  "maxTotalSale30dCnt": {
                    "type": "integer",
                    "description": "30-day sales (maximum)",
                    "example": 1
                  },
                  "minTotalSaleGmvAmt": {
                    "type": "string",
                    "description": "Product total GMV (minimum). Max length 1000"
                  },
                  "maxTotalSaleGmvAmt": {
                    "type": "string",
                    "description": "Product total GMV (maximum). Max length 1000"
                  },
                  "minTotalSaleGmv30dAmt": {
                    "type": "string",
                    "description": "Product total GMV (30-day) (minimum). Max length 1000"
                  },
                  "maxTotalSaleGmv30dAmt": {
                    "type": "string",
                    "description": "Product total GMV (30-day) (maximum). Max length 1000"
                  },
                  "minSpuAvgPrice": {
                    "type": "number",
                    "description": "SPU average price (minimum)",
                    "example": 1
                  },
                  "maxSpuAvgPrice": {
                    "type": "number",
                    "description": "SPU average price (maximum)",
                    "example": 1
                  },
                  "minProductRating": {
                    "type": "number",
                    "description": "Product rating (minimum)",
                    "example": 1
                  },
                  "maxProductRating": {
                    "type": "number",
                    "description": "Product rating (maximum)",
                    "example": 1
                  },
                  "minReviewCount": {
                    "type": "integer",
                    "description": "Review count (minimum)",
                    "example": 1
                  },
                  "maxReviewCount": {
                    "type": "integer",
                    "description": "Review count (maximum)",
                    "example": 1
                  },
                  "minProductCommissionRate": {
                    "type": "number",
                    "description": "Product commission rate (minimum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05",
                    "example": 1
                  },
                  "maxProductCommissionRate": {
                    "type": "number",
                    "description": "Product commission rate (maximum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05",
                    "example": 1
                  },
                  "minTotalIflCnt": {
                    "type": "integer",
                    "description": "Promoting creator count (minimum)",
                    "example": 1
                  },
                  "maxTotalIflCnt": {
                    "type": "integer",
                    "description": "Promoting creator count (maximum)",
                    "example": 1
                  },
                  "minTotalVideoCnt": {
                    "type": "integer",
                    "description": "Promotional video count (minimum)",
                    "example": 1
                  },
                  "maxTotalVideoCnt": {
                    "type": "integer",
                    "description": "Promotional video count (maximum)",
                    "example": 1
                  },
                  "minTotalViewsCnt": {
                    "type": "integer",
                    "description": "Promotional view count (minimum)",
                    "example": 1
                  },
                  "maxTotalViewsCnt": {
                    "type": "integer",
                    "description": "Promotional view count (maximum)",
                    "example": 1
                  },
                  "minFirstCrawlDt": {
                    "type": "integer",
                    "description": "Product listing time (minimum), format YYYYMMDD (e.g., 20200101 represents 2020-01-01)",
                    "example": 1
                  },
                  "maxFirstCrawlDt": {
                    "type": "integer",
                    "description": "Product listing time (maximum), format YYYYMMDD",
                    "example": 1
                  },
                  "saleDays": {
                    "type": "integer",
                    "description": "Days the product has been on sale, unit is days",
                    "example": 1
                  },
                  "productSortField": {
                    "type": "integer",
                    "description": "Sort field: 1=total sales, 2=total GMV, 3=SPU average price, 4=7-day sales, 5=30-day sales, 6=7-day GMV, 7=30-day GMV. Default 1",
                    "example": 1
                  },
                  "sortType": {
                    "type": "integer",
                    "description": "Sort direction: 0=ascending, 1=descending. Default 1",
                    "example": 1
                  },
                  "pageNum": {
                    "type": "integer",
                    "description": "Page number. Default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page. Default 50",
                    "example": 10
                  },
                  "pageNumber": {
                    "type": "integer"
                  }
                },
                "example": {
                  "region": "US",
                  "pageSize": 10,
                  "keyword": "phone case",
                  "pageNumber": 1
                },
                "additionalProperties": true
              },
              "example": {
                "region": "US",
                "pageSize": 10,
                "keyword": "phone case",
                "pageNumber": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product information list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "string",
                                        "description": "Product unique identifier ID",
                                        "example": "example-id"
                                      },
                                      "productName": {
                                        "type": "string",
                                        "description": "Product name",
                                        "example": null
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product name",
                                        "example": null
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "coverUrl": {
                                        "type": "string",
                                        "description": "Cover image URL list",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productImageUrls": {
                                        "type": "array",
                                        "description": "Product image URL list",
                                        "example": []
                                      },
                                      "categoryName": {
                                        "type": "string",
                                        "description": "Product category name",
                                        "example": null
                                      },
                                      "categoryIds": {
                                        "type": "array",
                                        "description": "Product category ID list",
                                        "example": []
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Region code",
                                        "example": "US"
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Product price",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum price",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Maximum price",
                                        "example": 1
                                      },
                                      "spuAvgPrice": {
                                        "type": "number",
                                        "description": "SPU average price",
                                        "example": 1
                                      },
                                      "productRating": {
                                        "type": "number",
                                        "description": "Product rating",
                                        "example": 1
                                      },
                                      "reviewCount": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "ratings": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "productCommissionRate": {
                                        "type": "number",
                                        "description": "Product commission rate",
                                        "example": 1
                                      },
                                      "totalSaleCnt": {
                                        "type": "integer",
                                        "description": "Total sales",
                                        "example": 1
                                      },
                                      "totalSale1dCnt": {
                                        "type": "integer",
                                        "description": "Total sales in 1 day",
                                        "example": 1
                                      },
                                      "totalSale7dCnt": {
                                        "type": "integer",
                                        "description": "Total sales in 7 days",
                                        "example": 1
                                      },
                                      "totalSale15dCnt": {
                                        "type": "integer",
                                        "description": "Total sales in 15 days",
                                        "example": 1
                                      },
                                      "totalSale30dCnt": {
                                        "type": "integer",
                                        "description": "Total sales in 30 days",
                                        "example": 1
                                      },
                                      "totalSale60dCnt": {
                                        "type": "integer",
                                        "description": "Total sales in 60 days",
                                        "example": 1
                                      },
                                      "totalSale90dCnt": {
                                        "type": "integer",
                                        "description": "Total sales in 90 days",
                                        "example": 1
                                      },
                                      "monthlySalesUnits": {
                                        "type": "integer",
                                        "description": "Monthly sales",
                                        "example": 1
                                      },
                                      "totalSaleGmvAmt": {
                                        "type": "number",
                                        "description": "Total GMV",
                                        "example": 1
                                      },
                                      "totalSaleGmv1dAmt": {
                                        "type": "number",
                                        "description": "Total GMV in 1 day",
                                        "example": 1
                                      },
                                      "totalSaleGmv7dAmt": {
                                        "type": "number",
                                        "description": "Total GMV in 7 days",
                                        "example": 1
                                      },
                                      "totalSaleGmv15dAmt": {
                                        "type": "number",
                                        "description": "Total GMV in 15 days",
                                        "example": 1
                                      },
                                      "totalSaleGmv30dAmt": {
                                        "type": "number",
                                        "description": "Total GMV in 30 days",
                                        "example": 1
                                      },
                                      "totalSaleGmv60dAmt": {
                                        "type": "number",
                                        "description": "Total GMV in 60 days",
                                        "example": 1
                                      },
                                      "totalSaleGmv90dAmt": {
                                        "type": "number",
                                        "description": "Total GMV in 90 days",
                                        "example": 1
                                      },
                                      "firstCrawlDt": {
                                        "type": "integer",
                                        "description": "Listing date",
                                        "example": 1
                                      },
                                      "availableDate": {
                                        "type": "string",
                                        "description": "Listing time (timestamp)",
                                        "example": "2026-01-01"
                                      },
                                      "discount": {
                                        "type": "string",
                                        "description": "Discount info",
                                        "example": null
                                      },
                                      "freeShippingText": {
                                        "type": "string",
                                        "description": "Whether free shipping",
                                        "example": null
                                      },
                                      "offMarkText": {
                                        "type": "string",
                                        "description": "Whether there is a discount mark",
                                        "example": null
                                      },
                                      "salesFlagText": {
                                        "type": "string",
                                        "description": "Selling method",
                                        "example": null
                                      },
                                      "salesTrendFlagText": {
                                        "type": "string",
                                        "description": "Sales trend indicator",
                                        "example": null
                                      },
                                      "isSShopText": {
                                        "type": "string",
                                        "description": "Whether S store",
                                        "example": null
                                      },
                                      "salePropsInfo": {
                                        "type": "array",
                                        "description": "Sales property info (product specifications)",
                                        "example": []
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Product source",
                                        "example": null
                                      },
                                      "asin": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "B072MQ5BRX"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": "example-id",
                        "imageUrl": "https://example.com/image.jpg",
                        "coverUrl": "https://example.com/image.jpg",
                        "productImageUrls": [],
                        "categoryIds": [],
                        "region": "US",
                        "price": 1,
                        "minPrice": 1,
                        "maxPrice": 1,
                        "spuAvgPrice": 1,
                        "productRating": 1,
                        "reviewCount": 1,
                        "ratings": 1,
                        "productCommissionRate": 1,
                        "totalSaleCnt": 1,
                        "totalSale1dCnt": 1,
                        "totalSale7dCnt": 1,
                        "totalSale15dCnt": 1,
                        "totalSale30dCnt": 1,
                        "totalSale60dCnt": 1,
                        "totalSale90dCnt": 1,
                        "monthlySalesUnits": 1,
                        "totalSaleGmvAmt": 1,
                        "totalSaleGmv1dAmt": 1,
                        "totalSaleGmv7dAmt": 1,
                        "totalSaleGmv15dAmt": 1,
                        "totalSaleGmv30dAmt": 1,
                        "totalSaleGmv60dAmt": 1,
                        "totalSaleGmv90dAmt": 1,
                        "firstCrawlDt": 1,
                        "availableDate": "2026-01-01",
                        "salePropsInfo": [],
                        "asin": "B072MQ5BRX"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-product-search",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_product_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-seller-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Seller Detail",
        "description": "Query TikTok Shop store (seller) details, retrieving a complete store profile by sellerId with total sales, multi-period (1d/7d/30d/90d) sales and GMV, followers, rating, review count, positive feedback rate, delivery rate, response rate, in-store product count, promoting creator count, promotional video count, livestream count, price range, product categories, and estimated listing time. Trigger when users mention TikTok store detail, TikTok seller detail, TikTok store analysis, TikTok store data, TikTok store profile, TikTok Shop store detail, TikTok seller detail, Nexscope store profile. Even if the user does not explicitly mention \"Nexscope\" or \"TikTok\", trigger this skill whenever their need involves querying the full detail/profile of a specific TikTok Shop store (with a known sellerId).",
        "operationId": "runTiktokSellerDetail",
        "externalDocs": {
          "description": "Tiktok Seller Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-seller-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-seller-detail.",
                "properties": {
                  "sellerId": {
                    "type": "string",
                    "description": "TikTok Shop seller ID. Obtainable from the \"Nexscope TikTok Seller Search\" skill (nexscope-echotik-list-seller) results, or from the ID in a known store link. Max length 1000",
                    "example": "7496162162184128712"
                  }
                },
                "required": [
                  "sellerId"
                ],
                "example": {
                  "sellerId": "7496162162184128712"
                },
                "additionalProperties": true
              },
              "example": {
                "sellerId": "7496162162184128712"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render column definitions (display metadata)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "sellerLink": {
                                        "type": "string",
                                        "description": "Store link",
                                        "example": null
                                      },
                                      "salesFlagText": {
                                        "type": "string",
                                        "description": "Primary selling method (video sales / livestream sales)",
                                        "example": null
                                      },
                                      "salesTrendFlagText": {
                                        "type": "string",
                                        "description": "Sales trend (rising / falling / stable)",
                                        "example": null
                                      },
                                      "shopIdentityLabel": {
                                        "type": "string",
                                        "description": "Store identity (e.g., OFFICIAL SHOP)",
                                        "example": null
                                      },
                                      "shopTypeText": {
                                        "type": "string",
                                        "description": "Whether a brand store (Yes / No)",
                                        "example": null
                                      },
                                      "fromFlagText": {
                                        "type": "string",
                                        "description": "Cross-border identifier (local / cross-border)",
                                        "example": null
                                      },
                                      "productCategoryList": {
                                        "type": "string",
                                        "description": "Product categories (JSON string, containing category_name / category_id)",
                                        "example": null
                                      },
                                      "mostProductCategoryList": {
                                        "type": "string",
                                        "description": "TOP1 product category (JSON string)",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style (e.g., tableListWorkbenches)",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sellerId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Store ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "coverUrl": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Store cover image URL",
                                  "example": "https://example.com/image.jpg"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "region": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Region",
                                  "example": "US"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "categoryId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Primary category ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "categoryL2Id": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Secondary category ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "categoryL3Id": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Tertiary category ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSaleCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total sales",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSale1dCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Sales in last 1 day (increment)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSale7dCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Sales in last 7 days (increment)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSale30dCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Sales in last 30 days (increment)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSale90dCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Sales in last 90 days (increment)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSaleGmvAmt": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Total GMV",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSaleGmv1dAmt": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "GMV in last 1 day (increment)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSaleGmv7dAmt": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "GMV in last 7 days (increment)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSaleGmv30dAmt": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "GMV in last 30 days (increment)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalSaleGmv90dAmt": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "GMV in last 90 days (increment)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "followersCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Follower count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "rating": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Rating",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "reviewCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Review count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "positiveFeedbackRate": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Positive feedback rate",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "responseRate": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Response rate",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "deliveryRate": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Delivery rate",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalProductCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Historical product count in store (including delisted)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalCrawlProductCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current product count in store",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "spuAvgPrice": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "description": "Average SKU price across the store",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "minPrice": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Minimum price",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "maxPrice": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Maximum price",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalIflCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total promoting creator count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalVideoCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total promotional video count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalLiveCnt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total livestream count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "firstCrawlDt": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Estimated listing time, in yyyyMMdd format (e.g., 20240504 represents 2024-05-04)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "userId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Creator UID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Product source (e.g., Tiktok)",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source tool (e.g., EchoTik-Seller Detail)",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "costToken": 1,
                    "columns": [],
                    "sellerId": "example-id",
                    "coverUrl": "https://example.com/image.jpg",
                    "region": "US",
                    "categoryId": "example-id",
                    "categoryL2Id": "example-id",
                    "categoryL3Id": "example-id",
                    "totalSaleCnt": 1,
                    "totalSale1dCnt": 1,
                    "totalSale7dCnt": 1,
                    "totalSale30dCnt": 1,
                    "totalSale90dCnt": 1,
                    "totalSaleGmvAmt": 1,
                    "totalSaleGmv1dAmt": 1,
                    "totalSaleGmv7dAmt": 1,
                    "totalSaleGmv30dAmt": 1,
                    "totalSaleGmv90dAmt": 1,
                    "followersCount": 1,
                    "rating": 1,
                    "reviewCount": 1,
                    "positiveFeedbackRate": 1,
                    "responseRate": 1,
                    "deliveryRate": 1,
                    "totalProductCnt": 1,
                    "totalCrawlProductCnt": 1,
                    "spuAvgPrice": 1,
                    "minPrice": 1,
                    "maxPrice": 1,
                    "totalIflCnt": 1,
                    "totalVideoCnt": 1,
                    "totalLiveCnt": 1,
                    "firstCrawlDt": 1,
                    "userId": "example-id"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-seller-detail",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_seller_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-shop-analytics/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Shop Analytics",
        "description": "Search TikTok e-commerce store leaderboards via Kalodata and query detailed information for specific stores. Supports viewing high-ranking, high-sales TikTok Shop stores by region, currency, language, and date range, and using shopId to retrieve revenue, sales volume, on-sale product count, self-operated/affiliate/shopping mall channel revenue, and creator collaboration count. Trigger when users mention TikTok store ranking, TikTok shop leaderboard, TikTok top shops, TikTok store ranking, TikTok Shop store ranking, kalodata store search, kalodata store ranking, TikTok store detail, TikTok shop profile, store revenue, store sales, TikTok shop ranking, TikTok shop leaderboard, TikTok top shops, TikTok store ranking, TikTok shop detail, TikTok store detail, kalodata shop search/detail. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok store leaderboards or detailed data for a specific TikTok store.",
        "operationId": "runTiktokShopAnalytics",
        "externalDocs": {
          "description": "Tiktok Shop Analytics documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-shop-analytics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-shop-analytics.",
                "properties": {
                  "region": {
                    "type": "string",
                    "description": "Region/market code, e.g., US. Max length 1000",
                    "example": "US"
                  },
                  "dateRange": {
                    "type": "string",
                    "description": "Time range, e.g., last7Day (last 7 days), last30Day (last 30 days). Max length 1000",
                    "example": "last30Day"
                  },
                  "pageNumber": {
                    "type": "integer",
                    "description": "Page number, value range 1-5 (out of range returns errcode 501)",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, value range 5-100",
                    "example": 10
                  },
                  "language": {
                    "type": "string",
                    "description": "Return language, e.g., zh-CN, en-US. Max length 1000"
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency unit, e.g., USD. Max length 1000"
                  },
                  "sortField": {
                    "type": "object",
                    "description": "Sort criteria; pass an empty object {} for default rank order when not sorting",
                    "example": {},
                    "properties": {},
                    "additionalProperties": true
                  },
                  "shopId": {
                    "type": "string",
                    "description": "TikTok shop unique ID (string, to avoid large integer precision loss), e.g., 7495514739648989419. Obtainable from the shop_id field in the shop rank response",
                    "example": "7496162162184128712"
                  },
                  "category_ids": {
                    "type": "array",
                    "description": "Category ID list filter; results use the selected category dimension",
                    "example": []
                  },
                  "revenue_range": {
                    "type": "string",
                    "description": "Revenue / GMV range filter"
                  },
                  "shop_type": {
                    "type": "string",
                    "description": "Shop type filter: BRAND or RETAILER"
                  },
                  "category_id": {
                    "type": "string",
                    "description": "Optional category ID dimension"
                  }
                },
                "example": {
                  "sortField": {},
                  "dateRange": "last30Day",
                  "pageSize": 10,
                  "shopId": "7496162162184128712",
                  "pageNumber": 1,
                  "region": "US"
                },
                "additionalProperties": true
              },
              "example": {
                "sortField": {},
                "dateRange": "last30Day",
                "pageSize": 10,
                "shopId": "7496162162184128712",
                "pageNumber": 1,
                "region": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Shop rank list (rank) or 1-element detail array (detail)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "rank": {
                                        "type": "integer",
                                        "description": "Rank position (1 is highest)",
                                        "example": 1
                                      },
                                      "shop_name": {
                                        "type": "string",
                                        "description": "Shop name",
                                        "example": null
                                      },
                                      "shop_id": {
                                        "type": "string",
                                        "description": "Shop unique ID (string, to avoid large integer precision loss)",
                                        "example": "example-id"
                                      },
                                      "shop_type": {
                                        "type": "string",
                                        "description": "Shop type (e.g., BRAND)",
                                        "example": null
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Total revenue / GMV (in the requested currency)",
                                        "example": 1
                                      },
                                      "sales_volumn": {
                                        "type": "integer",
                                        "description": "Sales volume (note the field is spelled volumn)",
                                        "example": 1
                                      },
                                      "on_sell_product_count": {
                                        "type": "integer",
                                        "description": "Products currently on sale",
                                        "example": 1
                                      },
                                      "unit_price": {
                                        "type": "number",
                                        "description": "Unit price (in the requested currency)",
                                        "example": 1
                                      },
                                      "revenue_growth_rate": {
                                        "type": "number",
                                        "description": "Revenue growth rate (%, can be positive or negative)",
                                        "example": 1
                                      },
                                      "self_promotion_revenue": {
                                        "type": "number",
                                        "description": "Self-operated/self-promoted revenue",
                                        "example": 1
                                      },
                                      "affiliate_revenue": {
                                        "type": "number",
                                        "description": "Affiliate distribution revenue",
                                        "example": 1
                                      },
                                      "shopping_mall_revenue": {
                                        "type": "number",
                                        "description": "Mall revenue",
                                        "example": 1
                                      },
                                      "seller_type": {
                                        "type": "string",
                                        "description": "Shop/seller type (e.g., BRAND) -- detail uses seller_type, not shop_type",
                                        "example": null
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Region/market (e.g., US)",
                                        "example": "US"
                                      },
                                      "product_number": {
                                        "type": "integer",
                                        "description": "Products currently on sale",
                                        "example": 1
                                      },
                                      "self_account_revenue": {
                                        "type": "number",
                                        "description": "Self-operated/self-broadcast revenue -- detail uses self_account_revenue, not self_promotion_revenue",
                                        "example": 1
                                      },
                                      "shoppingmall_revenue": {
                                        "type": "number",
                                        "description": "Mall revenue (note: no underscore between shopping and mall)",
                                        "example": 1
                                      },
                                      "creator_number": {
                                        "type": "integer",
                                        "description": "Creator collaborations",
                                        "example": 1
                                      },
                                      "video_number": {
                                        "type": "integer",
                                        "description": "Associated video count",
                                        "example": 1
                                      },
                                      "live_number": {
                                        "type": "integer",
                                        "description": "Associated livestream count",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed for this call, fixed at 14000",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": [
                      {
                        "rank": 1,
                        "shop_id": "example-id",
                        "revenue": 1,
                        "sales_volumn": 1,
                        "on_sell_product_count": 1,
                        "unit_price": 1,
                        "revenue_growth_rate": 1,
                        "self_promotion_revenue": 1,
                        "affiliate_revenue": 1,
                        "shopping_mall_revenue": 1,
                        "region": "US",
                        "product_number": 1,
                        "self_account_revenue": 1,
                        "shoppingmall_revenue": 1,
                        "creator_number": 1,
                        "video_number": 1,
                        "live_number": 1
                      }
                    ],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-shop-analytics",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_shop_analytics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-top-selling-products/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Top Selling Products",
        "description": "Query TikTok global e-commerce market top-selling product rankings via FastMoss data, supporting daily/weekly/monthly dimensions and category-level analysis. Trigger when users mention TikTok bestseller chart, TikTok hot product ranking, TikTok sales ranking, TikTok GMV ranking, TikTok category bestsellers, TikTok weekly product report, TikTok top-selling rankings, TikTok bestseller charts, TikTok GMV ranking, TikTok category hot sellers, TikTok weekly product report, FastMoss. Even if the user does not explicitly mention \"FastMoss\", trigger this skill whenever their need involves viewing TikTok platform bestseller rankings or sales rankings by time dimension.",
        "operationId": "runTiktokTopSellingProducts",
        "externalDocs": {
          "description": "Tiktok Top Selling Products documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-top-selling-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-top-selling-products.",
                "properties": {
                  "region": {
                    "type": "string",
                    "description": "Market region code. Options: US (United States), GB (United Kingdom), MX (Mexico), ES (Spain), DE (Germany), IT (Italy), FR (France), ID (Indonesia), VN (Vietnam), MY (Malaysia), TH (Thailand), PH (Philippines), BR (Brazil), JP (Japan), SG (Singapore)",
                    "example": "US"
                  },
                  "dateInfo": {
                    "type": "object",
                    "description": "Date specification object, containing type and value fields",
                    "example": {
                      "type": "day",
                      "value": "2026-08-01"
                    },
                    "properties": {
                      "type": {
                        "type": "string",
                        "description": "Time granularity: day, week, month",
                        "example": "day"
                      },
                      "value": {
                        "type": "string",
                        "description": "Date value: day format YYYY-MM-DD, week format YYYY-weekNumber (e.g., 2025-18), month format YYYY-MM",
                        "example": "2026-01-01"
                      }
                    },
                    "additionalProperties": true,
                    "required": [
                      "type",
                      "value"
                    ]
                  },
                  "category": {
                    "type": "string",
                    "description": "Product category name (English), matched to TikTok category ID. Non-English input must be translated to English first"
                  },
                  "orderby": {
                    "type": "object",
                    "description": "Sort rule object, containing field and order fields",
                    "example": {
                      "order": "desc",
                      "field": "units_sold"
                    },
                    "properties": {
                      "order": {
                        "type": "string",
                        "description": "Sort direction: desc (descending), asc (ascending), default desc",
                        "example": "desc"
                      },
                      "field": {
                        "type": "string",
                        "description": "Sort field: units_sold (sales), gmv (GMV), total_units_sold (total sales), total_gmv (total GMV), growth_rate (growth rate)",
                        "example": "units_sold"
                      }
                    },
                    "additionalProperties": true
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number, default 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, max 10, default 10",
                    "example": 10
                  }
                },
                "required": [
                  "region",
                  "dateInfo"
                ],
                "example": {
                  "region": "US",
                  "pageSize": 10,
                  "orderby": {
                    "order": "desc",
                    "field": "units_sold"
                  },
                  "dateInfo": {
                    "type": "day",
                    "value": "2026-08-01"
                  },
                  "page": 1
                },
                "additionalProperties": true
              },
              "example": {
                "region": "US",
                "pageSize": 10,
                "orderby": {
                  "order": "desc",
                  "field": "units_sold"
                },
                "dateInfo": {
                  "type": "day",
                  "value": "2026-08-01"
                },
                "page": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page number",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page size",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Hot selling product list (see product object below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "matchedCategoryIdPath": {
                                        "type": "string",
                                        "description": "Matched category ID path when category is supplied",
                                        "example": null
                                      },
                                      "matchedCategoryNamePath": {
                                        "type": "string",
                                        "description": "Matched category name path when category is supplied",
                                        "example": null
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product name",
                                        "example": null
                                      },
                                      "productId": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "example-id"
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Region code",
                                        "example": "US"
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Product price",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum price",
                                        "example": 1
                                      },
                                      "maxPrice": {
                                        "type": "number",
                                        "description": "Maximum price",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency",
                                        "example": null
                                      },
                                      "totalSaleCnt": {
                                        "type": "integer",
                                        "description": "Total sales",
                                        "example": 1
                                      },
                                      "totalSale1dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 1 day (returned when dateType=day)",
                                        "example": 1
                                      },
                                      "totalSale7dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 7 days (returned when dateType=week)",
                                        "example": 1
                                      },
                                      "totalSale30dCnt": {
                                        "type": "integer",
                                        "description": "Sales in last 30 days (returned when dateType=month)",
                                        "example": 1
                                      },
                                      "totalSaleGmvAmt": {
                                        "type": "number",
                                        "description": "Total GMV",
                                        "example": 1
                                      },
                                      "totalSaleGmv1dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 1 day (returned when dateType=day)",
                                        "example": 1
                                      },
                                      "totalSaleGmv7dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 7 days (returned when dateType=week)",
                                        "example": 1
                                      },
                                      "totalSaleGmv30dAmt": {
                                        "type": "number",
                                        "description": "GMV in last 30 days (returned when dateType=month)",
                                        "example": 1
                                      },
                                      "growthRate": {
                                        "type": "number",
                                        "description": "Growth rate (percentage)",
                                        "example": 1
                                      },
                                      "shopName": {
                                        "type": "string",
                                        "description": "Store name",
                                        "example": null
                                      },
                                      "shopTotalUnitsSold": {
                                        "type": "integer",
                                        "description": "Store total sales",
                                        "example": 1
                                      },
                                      "shopSellerId": {
                                        "type": "string",
                                        "description": "Store seller ID",
                                        "example": "example-id"
                                      },
                                      "categoryName": {
                                        "type": "string",
                                        "description": "Product category",
                                        "example": null
                                      },
                                      "categoryIds": {
                                        "type": "array",
                                        "description": "Category ID path from first to third level",
                                        "example": null
                                      },
                                      "productCommissionRate": {
                                        "type": "number",
                                        "description": "Product commission rate (basis points, 1000=10%)",
                                        "example": 1
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "coverUrl": {
                                        "type": "array",
                                        "description": "Product cover image URLs",
                                        "example": null
                                      },
                                      "shopAvatar": {
                                        "type": "string",
                                        "description": "Shop avatar URL",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Product source type",
                                        "example": null
                                      },
                                      "offShelvesText": {
                                        "type": "string",
                                        "description": "Whether delisted (\"Yes\"=delisted, \"No\"=on sale)",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Upstream execution time in milliseconds",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": "example-id",
                        "region": "US",
                        "price": 1,
                        "minPrice": 1,
                        "maxPrice": 1,
                        "totalSaleCnt": 1,
                        "totalSale1dCnt": 1,
                        "totalSale7dCnt": 1,
                        "totalSale30dCnt": 1,
                        "totalSaleGmvAmt": 1,
                        "totalSaleGmv1dAmt": 1,
                        "totalSaleGmv7dAmt": 1,
                        "totalSaleGmv30dAmt": 1,
                        "growthRate": 1,
                        "shopTotalUnitsSold": 1,
                        "shopSellerId": "example-id",
                        "productCommissionRate": 1,
                        "imageUrl": "https://example.com/image.jpg"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-top-selling-products",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_top_selling_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-video-analytics/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Video Analytics",
        "description": "Search TikTok e-commerce trending promotional video leaderboards via Kalodata and query detailed data for specific videos. Supports viewing high-ranking/high-view/hot-selling promotional videos by region, currency, language, and date range, and using videoId to retrieve views, likes, comments, shares, revenue, GPM, and advertising metrics. Trigger when users mention TikTok video search, TikTok video ranking, TikTok viral video chart, TikTok video detail, video analytics, kalodata video search/detail. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok trending promotional video leaderboards or detailed sales and engagement data for a specific TikTok video.",
        "operationId": "runTiktokVideoAnalytics",
        "externalDocs": {
          "description": "Tiktok Video Analytics documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-video-analytics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-video-analytics.",
                "properties": {
                  "region": {
                    "type": "string",
                    "description": "Region/market code, e.g., US",
                    "example": "US"
                  },
                  "dateRange": {
                    "type": "string",
                    "description": "Time range, e.g., last7Day, last30Day",
                    "example": "last30Day"
                  },
                  "pageNumber": {
                    "type": "integer",
                    "description": "Page number, value range 1-5",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page, value range 5-100",
                    "example": 10
                  },
                  "language": {
                    "type": "string",
                    "description": "Return language, e.g., zh-CN, en-US"
                  },
                  "currency": {
                    "type": "string",
                    "description": "Currency unit, e.g., USD"
                  },
                  "sortField": {
                    "type": "object",
                    "description": "Sort criteria; omitted to use default rank order",
                    "example": {},
                    "properties": {},
                    "additionalProperties": true
                  },
                  "videoId": {
                    "type": "string",
                    "description": "TikTok video ID, e.g., 7659161409279806734, obtainable from the video_id in the video rank response",
                    "example": "6768504823336815877"
                  },
                  "category_id": {
                    "type": "string",
                    "description": "Category ID filter"
                  },
                  "shop_id": {
                    "type": "string",
                    "description": "Shop ID filter"
                  },
                  "creator_id": {
                    "type": "string",
                    "description": "Creator ID filter"
                  },
                  "product_id": {
                    "type": "string",
                    "description": "Product ID filter"
                  },
                  "revenue_range": {
                    "type": "string",
                    "description": "GMV range; response field revenue is total GMV"
                  },
                  "followers_range": {
                    "type": "string",
                    "description": "Creator follower range filter"
                  },
                  "ads_roas": {
                    "type": "number",
                    "description": "Advertising ROAS filter"
                  }
                },
                "example": {
                  "sortField": {},
                  "dateRange": "last30Day",
                  "pageSize": 10,
                  "pageNumber": 1,
                  "region": "US",
                  "videoId": "6768504823336815877"
                },
                "additionalProperties": true
              },
              "example": {
                "sortField": {},
                "dateRange": "last30Day",
                "pageSize": 10,
                "pageNumber": 1,
                "region": "US",
                "videoId": "6768504823336815877"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rank or detail data",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "video_id": {
                                        "type": "string",
                                        "description": "Video ID, string format to avoid large integer precision loss",
                                        "example": "example-id"
                                      },
                                      "video_title": {
                                        "type": "string",
                                        "description": "Video title / caption",
                                        "example": null
                                      },
                                      "views": {
                                        "type": "integer",
                                        "description": "View count",
                                        "example": 1
                                      },
                                      "digg_count": {
                                        "type": "integer",
                                        "description": "Like count",
                                        "example": 1
                                      },
                                      "comment_count": {
                                        "type": "integer",
                                        "description": "Comment count",
                                        "example": 1
                                      },
                                      "share_count": {
                                        "type": "integer",
                                        "description": "Share count",
                                        "example": 1
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Total revenue / GMV, returned in the requested currency",
                                        "example": 1
                                      },
                                      "revenue_growth_rate": {
                                        "type": "number",
                                        "description": "Revenue growth rate (%), can be positive or negative",
                                        "example": 1
                                      },
                                      "ad": {
                                        "type": "integer",
                                        "description": "Whether ad/promotional video flag (1=yes)",
                                        "example": 1
                                      },
                                      "ad_view_ratio": {
                                        "type": "number",
                                        "description": "Ad view share (%)",
                                        "example": 1
                                      },
                                      "ad_revenue_ratio": {
                                        "type": "number",
                                        "description": "Ad revenue share (%)",
                                        "example": 1
                                      },
                                      "ads_roas": {
                                        "type": "number",
                                        "description": "Ad ROAS",
                                        "example": 1
                                      },
                                      "belonged_creator_id": {
                                        "type": "string",
                                        "description": "Belonged creator ID",
                                        "example": "example-id"
                                      },
                                      "belonged_creator_handle": {
                                        "type": "string",
                                        "description": "Belonged creator username",
                                        "example": null
                                      },
                                      "creator_debut": {
                                        "type": "string",
                                        "description": "Creator debut date (YYYY-MM-DD)",
                                        "example": null
                                      },
                                      "video_region": {
                                        "type": "string",
                                        "description": "Video region, may be empty string",
                                        "example": null
                                      },
                                      "sales_volumn": {
                                        "type": "integer",
                                        "description": "Sales volume, field spelled as volumn",
                                        "example": 1
                                      },
                                      "video_gpm": {
                                        "type": "number",
                                        "description": "Video GPM (GMV per thousand views)",
                                        "example": 1
                                      },
                                      "ads_views": {
                                        "type": "integer",
                                        "description": "Ad view count",
                                        "example": 1
                                      },
                                      "ad_cpa": {
                                        "type": "number",
                                        "description": "Ad CPA",
                                        "example": 1
                                      },
                                      "ads_period": {
                                        "type": "integer",
                                        "description": "Ad running period (days)",
                                        "example": 1
                                      },
                                      "duration": {
                                        "type": "number",
                                        "description": "Video duration (seconds)",
                                        "example": 1
                                      },
                                      "product_number": {
                                        "type": "integer",
                                        "description": "Associated product count in the video",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed for this call, typically 14000",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": [
                      {
                        "video_id": "example-id",
                        "views": 1,
                        "digg_count": 1,
                        "comment_count": 1,
                        "share_count": 1,
                        "revenue": 1,
                        "revenue_growth_rate": 1,
                        "ad": 1,
                        "ad_view_ratio": 1,
                        "ad_revenue_ratio": 1,
                        "ads_roas": 1,
                        "belonged_creator_id": "example-id",
                        "sales_volumn": 1,
                        "video_gpm": 1,
                        "ads_views": 1,
                        "ad_cpa": 1,
                        "ads_period": 1,
                        "duration": 1,
                        "product_number": 1
                      }
                    ],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-video-analytics",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_video_analytics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-video-download-url/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Video Download Url",
        "description": "Resolve TikTok video URLs to return no-watermark/watermarked download addresses, playback addresses, and cover image addresses for saving promotional video assets or offline analysis. Trigger when users mention TikTok video download, TikTok watermark-free download, TikTok video save, download TikTok promotional video, TikTok no watermark video, TikTok video download, download TikTok video, no watermark TikTok video, save TikTok video, TikTok video link resolution. Even if the user does not explicitly mention \"Nexscope\", trigger this skill whenever their need involves extracting downloadable/playable video addresses from a TikTok video link.",
        "operationId": "runTiktokVideoDownloadUrl",
        "externalDocs": {
          "description": "Tiktok Video Download Url documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-video-download-url"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-video-download-url.",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "TikTok video URL, supports two formats: https://vt.tiktok.com/xxx short link or https://www.tiktok.com/@user/video/xxx full link. Max length 1000",
                    "example": "https://www.tiktok.com/@zachking/video/6768504823336815877"
                  }
                },
                "required": [
                  "url"
                ],
                "example": {
                  "url": "https://www.tiktok.com/@zachking/video/6768504823336815877"
                },
                "additionalProperties": true
              },
              "example": {
                "url": "https://www.tiktok.com/@zachking/video/6768504823336815877"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "noWatermarkDownloadUrl": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Video download URL (no watermark). Not all videos return this: some videos omit this field, in which case no-watermark download is unavailable",
                                  "example": "https://example.com/image.jpg"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "downloadUrl": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Video download URL (with watermark). Not all videos return this: omitted or present together with the no-watermark URL",
                                  "example": "https://example.com/image.jpg"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "playUrl": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Video play URL. When download URLs are absent, this serves as a fallback for playback/preview",
                                  "example": "https://example.com/image.jpg"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "coverUrl": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Video cover image URL (static)",
                                  "example": "https://example.com/image.jpg"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dynamicCoverUrl": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Video dynamic cover URL",
                                  "example": "https://example.com/image.jpg"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "videoId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Video ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render column definitions (field metadata: field/title/cellType/filterable/sortable, for frontend table rendering)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style (e.g., tableListWorkbenches)",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "noWatermarkDownloadUrl": "https://example.com/image.jpg",
                    "downloadUrl": "https://example.com/image.jpg",
                    "playUrl": "https://example.com/image.jpg",
                    "coverUrl": "https://example.com/image.jpg",
                    "dynamicCoverUrl": "https://example.com/image.jpg",
                    "videoId": "example-id",
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-video-download-url",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_video_download_url",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-video-search/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "Tiktok Video Search",
        "description": "Search and analyze TikTok video data, filter videos by region, creator, product, category, views, duration, publish time, selling/ad/AI video flags, and return views, likes, comments, shares, favorites, video sales and GMV metrics across 16 TikTok Shop sites. Trigger when users mention TikTok video search, TikTok video list, TikTok promotional videos, TikTok video data, TikTok video views, TikTok video sales, TikTok video analytics, Nexscope video, TikTok video search, TikTok video list, TikTok video analytics, TikTok promotional videos, TikTok video views, TikTok video engagement. Even if the user does not explicitly mention \"Nexscope\" or \"TikTok\", trigger this skill whenever their need involves searching or analyzing TikTok video performance metrics by criteria.",
        "operationId": "runTiktokVideoSearch",
        "externalDocs": {
          "description": "Tiktok Video Search documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-video-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.tiktok-video-search.",
                "properties": {
                  "region": {
                    "type": "string",
                    "description": "Region code. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)",
                    "example": "US"
                  },
                  "userId": {
                    "type": "string",
                    "description": "Creator ID filter. Max length 1000",
                    "example": "example-id"
                  },
                  "productId": {
                    "type": "string",
                    "description": "Associated product ID. Max length 1000"
                  },
                  "productCategoryId": {
                    "type": "string",
                    "description": "Associated product category ID. Max length 1000",
                    "example": "example-id"
                  },
                  "minTotalViewsCnt": {
                    "type": "integer",
                    "description": "Video view count filter (minimum)",
                    "example": 1
                  },
                  "maxTotalViewsCnt": {
                    "type": "integer",
                    "description": "Video view count filter (maximum)",
                    "example": 1
                  },
                  "minDuration": {
                    "type": "integer",
                    "description": "Video duration range filter (seconds) - minimum",
                    "example": 1
                  },
                  "maxDuration": {
                    "type": "integer",
                    "description": "Video duration range filter (seconds) - maximum",
                    "example": 1
                  },
                  "minCreateTime": {
                    "type": "integer",
                    "description": "Publish time range filter (seconds-level timestamp) - minimum",
                    "example": 1
                  },
                  "maxCreateTime": {
                    "type": "integer",
                    "description": "Publish time range filter (seconds-level timestamp) - maximum",
                    "example": 1
                  },
                  "salesFlag": {
                    "type": "integer",
                    "description": "Whether a promotional video: 0=non-promotional video, 1=promotional video",
                    "example": 1
                  },
                  "isAd": {
                    "type": "integer",
                    "description": "Whether an ad video: 0=non-ad video, 1=ad video",
                    "example": 1
                  },
                  "createdByAi": {
                    "type": "string",
                    "description": "Whether AI video, string \"true\"=AI video, \"false\"=non-AI video (regex ^(true"
                  },
                  "videoSortField": {
                    "type": "integer",
                    "description": "Sort field: 1=total_digg_cnt (likes), 2=create_time (publish time), 3=total_views_cnt (views)",
                    "example": 1
                  },
                  "sortType": {
                    "type": "integer",
                    "description": "Sort direction: 0=ascending, 1=descending",
                    "example": 1
                  },
                  "pageNum": {
                    "type": "integer",
                    "description": "Page number, starting from 1",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page. Must be a multiple of 10, max 100; the third-party API limit is 10 per page, internally the gateway fetches 10 per page in multiple rounds and merges",
                    "example": 10
                  },
                  "keyword": {
                    "type": "string"
                  },
                  "pageNumber": {
                    "type": "integer"
                  }
                },
                "required": [
                  "region"
                ],
                "example": {
                  "region": "US",
                  "pageSize": 10,
                  "keyword": "phone case",
                  "pageNumber": 1
                },
                "additionalProperties": true
              },
              "example": {
                "region": "US",
                "pageSize": 10,
                "keyword": "phone case",
                "pageNumber": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Video list (see video fields below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "videoId": {
                                        "type": "string",
                                        "description": "Video ID",
                                        "example": "example-id"
                                      },
                                      "videoDesc": {
                                        "type": "string",
                                        "description": "Video description",
                                        "example": null
                                      },
                                      "officialUrl": {
                                        "type": "string",
                                        "description": "TikTok official video URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "coverUrl": {
                                        "type": "string",
                                        "description": "Video cover URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "duration": {
                                        "type": "integer",
                                        "description": "Video duration (seconds)",
                                        "example": 1
                                      },
                                      "width": {
                                        "type": "string",
                                        "description": "Video width",
                                        "example": null
                                      },
                                      "height": {
                                        "type": "string",
                                        "description": "Video height",
                                        "example": null
                                      },
                                      "ratio": {
                                        "type": "string",
                                        "description": "Video resolution (e.g., 540p/720p)",
                                        "example": null
                                      },
                                      "dataSize": {
                                        "type": "string",
                                        "description": "Video file size",
                                        "example": null
                                      },
                                      "createDate": {
                                        "type": "string",
                                        "description": "Video publish date",
                                        "example": "2026-01-01"
                                      },
                                      "userId": {
                                        "type": "string",
                                        "description": "Creator ID",
                                        "example": "example-id"
                                      },
                                      "uniqueId": {
                                        "type": "string",
                                        "description": "TikTok account ID (unique_id)",
                                        "example": "example-id"
                                      },
                                      "avatar": {
                                        "type": "string",
                                        "description": "Creator avatar",
                                        "example": null
                                      },
                                      "totalViewsCnt": {
                                        "type": "integer",
                                        "description": "Total view count",
                                        "example": 1
                                      },
                                      "totalViews1dCnt": {
                                        "type": "integer",
                                        "description": "Views in last 1 day",
                                        "example": 1
                                      },
                                      "totalViews7dCnt": {
                                        "type": "integer",
                                        "description": "Views in last 7 days",
                                        "example": 1
                                      },
                                      "totalViews30dCnt": {
                                        "type": "integer",
                                        "description": "Views in last 30 days",
                                        "example": 1
                                      },
                                      "totalDiggCnt": {
                                        "type": "integer",
                                        "description": "Total like count",
                                        "example": 1
                                      },
                                      "totalDigg1dCnt": {
                                        "type": "integer",
                                        "description": "Likes in last 1 day",
                                        "example": 1
                                      },
                                      "totalDigg7dCnt": {
                                        "type": "integer",
                                        "description": "Likes in last 7 days",
                                        "example": 1
                                      },
                                      "totalDigg30dCnt": {
                                        "type": "integer",
                                        "description": "Likes in last 30 days",
                                        "example": 1
                                      },
                                      "totalCommentsCnt": {
                                        "type": "integer",
                                        "description": "Total comment count",
                                        "example": 1
                                      },
                                      "totalSharesCnt": {
                                        "type": "integer",
                                        "description": "Total share count",
                                        "example": 1
                                      },
                                      "totalFavoritesCnt": {
                                        "type": "integer",
                                        "description": "Total favorite count",
                                        "example": 1
                                      },
                                      "totalVideoSaleCnt": {
                                        "type": "integer",
                                        "description": "Video sales (units)",
                                        "example": 1
                                      },
                                      "totalVideoSaleGmvAmt": {
                                        "type": "integer",
                                        "description": "Video sales GMV (amount)",
                                        "example": 1
                                      },
                                      "salesFlagText": {
                                        "type": "string",
                                        "description": "Whether promotional video",
                                        "example": null
                                      },
                                      "isAdText": {
                                        "type": "string",
                                        "description": "Whether ad video",
                                        "example": null
                                      },
                                      "createdByAiText": {
                                        "type": "string",
                                        "description": "Whether AI video (Yes/No/Unknown)",
                                        "example": null
                                      },
                                      "productCategoryList": {
                                        "type": "string",
                                        "description": "Product categories",
                                        "example": null
                                      },
                                      "videoProducts": {
                                        "type": "string",
                                        "description": "Video associated products",
                                        "example": null
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Region code",
                                        "example": "US"
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Product source",
                                        "example": null
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "data": [
                      {
                        "videoId": "example-id",
                        "officialUrl": "https://example.com/image.jpg",
                        "coverUrl": "https://example.com/image.jpg",
                        "duration": 1,
                        "createDate": "2026-01-01",
                        "userId": "example-id",
                        "uniqueId": "example-id",
                        "totalViewsCnt": 1,
                        "totalViews1dCnt": 1,
                        "totalViews7dCnt": 1,
                        "totalViews30dCnt": 1,
                        "totalDiggCnt": 1,
                        "totalDigg1dCnt": 1,
                        "totalDigg7dCnt": 1,
                        "totalDigg30dCnt": 1,
                        "totalCommentsCnt": 1,
                        "totalSharesCnt": 1,
                        "totalFavoritesCnt": 1,
                        "totalVideoSaleCnt": 1,
                        "totalVideoSaleGmvAmt": 1,
                        "region": "US"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-video-search",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_video_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/utility-patent-detector/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Utility Patent Detector",
        "description": "Detect and search for similar utility/invention patents based on product information. Trigger when users mention utility patent detection, patent infringement risk, patent similarity search, patent screening, invention patent search, patent risk assessment, TRO (Temporary Restraining Order) risk analysis, utility patent, invention patent detection, patent infringement risk, patent search, TRO risk, Ruiguan. Even if the user does not explicitly say \"utility patent\", trigger this skill whenever their need involves checking whether a product may infringe existing utility/invention patents before selling in a target market.",
        "operationId": "runUtilityPatentDetector",
        "externalDocs": {
          "description": "Utility Patent Detector documentation",
          "url": "https://www.nexscope.ai/api-docs/utility-patent-detector"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.utility-patent-detector.",
                "properties": {
                  "productTitle": {
                    "type": "string",
                    "description": "Product title, max 1000 characters",
                    "example": "Magnetic phone case with ring stand"
                  },
                  "productDescription": {
                    "type": "string",
                    "description": "Product description, max 1000 characters",
                    "example": "A protective smartphone case with a magnetic ring stand and shockproof corners."
                  },
                  "region": {
                    "type": "string",
                    "description": "Country/region code(s) where the product is intended for sale, multiple separated by commas. Currently supports US. Default US",
                    "example": "US"
                  },
                  "topNumber": {
                    "type": "integer",
                    "description": "Number of results to recall, range: 10--200, default 100",
                    "example": 10
                  }
                },
                "required": [
                  "productTitle",
                  "productDescription",
                  "region",
                  "topNumber"
                ],
                "example": {
                  "topNumber": 10,
                  "productDescription": "A protective smartphone case with a magnetic ring stand and shockproof corners.",
                  "region": "US",
                  "productTitle": "Magnetic phone case with ring stand"
                },
                "additionalProperties": true
              },
              "example": {
                "topNumber": 10,
                "productDescription": "A protective smartphone case with a magnetic ring stand and shockproof corners.",
                "region": "US",
                "productTitle": "Magnetic phone case with ring stand"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "detectId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Detection ID",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Render column definitions",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Patent list (see below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "globalUtilityId": {
                                        "type": "string",
                                        "description": "Patent ID",
                                        "example": "example-id"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Utility patent title",
                                        "example": null
                                      },
                                      "titleCn": {
                                        "type": "string",
                                        "description": "Utility patent title (Chinese)",
                                        "example": null
                                      },
                                      "similarity": {
                                        "type": "number",
                                        "description": "Similarity between the product and this patent (0--1)",
                                        "example": 1
                                      },
                                      "patentValidity": {
                                        "type": "string",
                                        "description": "Patent validity: Active or Invalid",
                                        "example": null
                                      },
                                      "applicationNumber": {
                                        "type": "string",
                                        "description": "Application number",
                                        "example": null
                                      },
                                      "applicationDate": {
                                        "type": "string",
                                        "description": "Application date (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "publicationNumber": {
                                        "type": "string",
                                        "description": "Publication number",
                                        "example": null
                                      },
                                      "publicationDate": {
                                        "type": "string",
                                        "description": "Publication date (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "estimatedDueDate": {
                                        "type": "string",
                                        "description": "Estimated expiration date (yyyy-MM-dd)",
                                        "example": "2026-01-01"
                                      },
                                      "region": {
                                        "type": "string",
                                        "description": "Receiving office",
                                        "example": "US"
                                      },
                                      "patentAbstract": {
                                        "type": "string",
                                        "description": "Abstract",
                                        "example": null
                                      },
                                      "patentAbstractCn": {
                                        "type": "string",
                                        "description": "Abstract (Chinese)",
                                        "example": null
                                      },
                                      "claims": {
                                        "type": "string",
                                        "description": "Claims",
                                        "example": null
                                      },
                                      "claimsCn": {
                                        "type": "string",
                                        "description": "Claims (Chinese)",
                                        "example": null
                                      },
                                      "specification": {
                                        "type": "string",
                                        "description": "Specification",
                                        "example": null
                                      },
                                      "specificationCn": {
                                        "type": "string",
                                        "description": "Specification (Chinese)",
                                        "example": null
                                      },
                                      "inventors": {
                                        "type": "array",
                                        "description": "Inventors and countries concatenated, array format",
                                        "example": []
                                      },
                                      "inventorAddresses": {
                                        "type": "array",
                                        "description": "Inventor addresses, array format",
                                        "example": []
                                      },
                                      "applicants": {
                                        "type": "array",
                                        "description": "Applicants and countries concatenated, array format",
                                        "example": []
                                      },
                                      "applicantAddresses": {
                                        "type": "array",
                                        "description": "Rights holder addresses, array format",
                                        "example": []
                                      },
                                      "priorityNumber": {
                                        "type": "array",
                                        "description": "Priority numbers, array format",
                                        "example": []
                                      },
                                      "relatedPublicationDate": {
                                        "type": "array",
                                        "description": "First publication dates (yyyy-MM-dd), array format",
                                        "example": []
                                      },
                                      "patentImageUrl": {
                                        "type": "string",
                                        "description": "Patent cover image",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "images": {
                                        "type": "array",
                                        "description": "Patent drawings",
                                        "example": []
                                      },
                                      "classNumList": {
                                        "type": "array",
                                        "description": "Classification number path list, format: classNum1 > classNum2 > classNum3",
                                        "example": []
                                      },
                                      "cpcKindRaw": {
                                        "type": "array",
                                        "description": "CPC classification (raw JSONArray)",
                                        "example": []
                                      },
                                      "troCase": {
                                        "type": "boolean",
                                        "description": "Whether there is a TRO enforcement history",
                                        "example": false
                                      },
                                      "troHolder": {
                                        "type": "boolean",
                                        "description": "Whether it is a patent of a TRO rights holder",
                                        "example": false
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "detectId": "example-id",
                    "costToken": 1,
                    "columns": [],
                    "data": [
                      {
                        "globalUtilityId": "example-id",
                        "similarity": 1,
                        "applicationDate": "2026-01-01",
                        "publicationDate": "2026-01-01",
                        "estimatedDueDate": "2026-01-01",
                        "region": "US",
                        "inventors": [],
                        "inventorAddresses": [],
                        "applicants": [],
                        "applicantAddresses": [],
                        "priorityNumber": [],
                        "relatedPublicationDate": [],
                        "patentImageUrl": "https://example.com/image.jpg",
                        "images": [],
                        "classNumList": [],
                        "cpcKindRaw": [],
                        "troCase": false,
                        "troHolder": false
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "utility-patent-detector",
        "x-nexscope-mcp-tool-name": "nexscope_utility_patent_detector",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/walmart-product-detail/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Walmart Product Detail",
        "description": "Query Walmart product details via Nexscope, including pricing history and sales trends. Trigger when users mention Walmart product detail, Walmart product data, Nexscope, Walmart price trends, Walmart sales trends, Walmart product detail, Walmart price history, Walmart sales trend, Nexscope product. Even if the user does not explicitly mention \"Nexscope\", trigger this skill whenever their need involves viewing detailed information, historical price changes, or sales trends for a single Walmart product.",
        "operationId": "runWalmartProductDetail",
        "externalDocs": {
          "description": "Walmart Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/walmart-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.walmart-product-detail.",
                "properties": {
                  "productId": {
                    "type": [
                      "integer",
                      "string"
                    ],
                    "description": "Product ID (ItemId), the numeric ID contained in the product detail link. For example: the 5169493923 in https://www.walmart.com/ip/5169493923",
                    "example": "5169493923"
                  },
                  "includeStats": {
                    "type": "boolean",
                    "description": "Whether to include historical price/historical sales, default true",
                    "example": false
                  }
                },
                "required": [
                  "productId"
                ],
                "example": {
                  "includeStats": false,
                  "productId": "5169493923"
                },
                "additionalProperties": true
              },
              "example": {
                "includeStats": false,
                "productId": "5169493923"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of products returned (typically 1 for this endpoint)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see product object below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "usItemId": {
                                        "type": "integer",
                                        "description": "Internal product ID (same as the requested productId)",
                                        "example": 1
                                      },
                                      "productId": {
                                        "type": "string",
                                        "description": "Walmart product unique identifier (alphanumeric, e.g., \"6YBM50F6ZXAE\")",
                                        "example": "example-id"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Product name",
                                        "example": null
                                      },
                                      "description": {
                                        "type": "string",
                                        "description": "Product description",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Current selling price (USD)",
                                        "example": 1
                                      },
                                      "wasPrice": {
                                        "type": "number",
                                        "description": "Striketrough price (USD), may be null when no discount",
                                        "example": 1
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum price (USD)",
                                        "example": 1
                                      },
                                      "brand": {
                                        "type": "string",
                                        "description": "Brand name",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Product rating (0.0-5.0)",
                                        "example": 1
                                      },
                                      "reviews": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "salesEstimate": {
                                        "type": "integer",
                                        "description": "Sales estimate (units, in recent period)",
                                        "example": 1
                                      },
                                      "revenue": {
                                        "type": "number",
                                        "description": "Revenue estimate (USD)",
                                        "example": 1
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "fulfillmentType": {
                                        "type": "string",
                                        "description": "Fulfillment type: \"MARKETPLACE\" (third-party seller self-fulfilled) or \"WFS\" (Walmart Fulfillment Services)",
                                        "example": null
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Product page URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Product image URL (thumbnail)",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "departmentName": {
                                        "type": "string",
                                        "description": "Department name (e.g., \"Cell Phones\")",
                                        "example": null
                                      },
                                      "departmentId": {
                                        "type": "integer",
                                        "description": "Department ID",
                                        "example": 1
                                      },
                                      "listingScore": {
                                        "type": "integer",
                                        "description": "Listing quality score",
                                        "example": 1
                                      },
                                      "contentScore": {
                                        "type": "integer",
                                        "description": "Content quality score",
                                        "example": 1
                                      },
                                      "outOfStock": {
                                        "type": "integer",
                                        "description": "Whether out of stock (0=in stock, 1=out of stock)",
                                        "example": 1
                                      },
                                      "sponsored": {
                                        "type": "integer",
                                        "description": "Whether a sponsored product (0=no, 1=yes)",
                                        "example": 1
                                      },
                                      "isBranded": {
                                        "type": "integer",
                                        "description": "Whether a branded product (0=no, 1=yes)",
                                        "example": 1
                                      },
                                      "multipleOptionsAvailable": {
                                        "type": "integer",
                                        "description": "Whether there are variants (0=no, 1=yes)",
                                        "example": 1
                                      },
                                      "createdAt": {
                                        "type": "string",
                                        "description": "First indexed time by Nexscope (format: yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z')",
                                        "example": null
                                      },
                                      "updatedAt": {
                                        "type": "string",
                                        "description": "Most recent data update time (same format as above)",
                                        "example": "2026-01-01T00:00:00.000000Z"
                                      },
                                      "stats": {
                                        "type": "object",
                                        "description": "Historical statistics (only returned when includeStats=true, otherwise null. See structure below)",
                                        "example": {},
                                        "properties": {
                                          "price": {
                                            "type": "array",
                                            "description": "Historical selling price time series (sorted by date ascending). Each item is a single date-price mapping",
                                            "example": []
                                          },
                                          "sales": {
                                            "type": "array",
                                            "description": "Historical sales time series (sorted by date ascending). Each item is a single date-sales mapping",
                                            "example": []
                                          }
                                        }
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool identifier",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Product source platform (fixed value \"walmart\")",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions (metadata describing each field in products, including field, title, cellType, etc.)",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response render type (fixed value \"productWorkbenches\")",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API elapsed time (milliseconds)",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "usItemId": 1,
                        "productId": "example-id",
                        "price": 1,
                        "wasPrice": 1,
                        "minPrice": 1,
                        "rating": 1,
                        "reviews": 1,
                        "salesEstimate": 1,
                        "revenue": 1,
                        "productPageUrl": "https://example.com/image.jpg",
                        "imageUrl": "https://example.com/image.jpg",
                        "departmentId": 1,
                        "listingScore": 1,
                        "contentScore": 1,
                        "outOfStock": 1,
                        "sponsored": 1,
                        "isBranded": 1,
                        "multipleOptionsAvailable": 1,
                        "updatedAt": "2026-01-01T00:00:00.000000Z",
                        "stats": {
                          "price": [],
                          "sales": []
                        }
                      }
                    ],
                    "columns": [],
                    "costTime": 1,
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "walmart-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_walmart_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/walmart-search/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Walmart Search",
        "description": "Search and browse Walmart product listings by keyword, category, price range, and other conditions. Trigger when users mention Walmart product search, Walmart product listing, Walmart price comparison, Walmart competitor analysis, Walmart product research, Walmart market data, find products on Walmart, Walmart search, Walmart products, Walmart product selection, Walmart pricing, Walmart competitors, Walmart market. Even if the user does not explicitly mention \"Walmart search\", trigger this skill whenever their need involves searching for products on Walmart, checking product availability, comparing Walmart prices, or analyzing Walmart product listings.",
        "operationId": "runWalmartSearch",
        "externalDocs": {
          "description": "Walmart Search documentation",
          "url": "https://www.nexscope.ai/api-docs/walmart-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.walmart-search.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Search keyword, max length 1024 characters. *At least one of keyword and categoryId must be provided",
                    "example": "phone case"
                  },
                  "categoryId": {
                    "type": "string",
                    "description": "Category ID. *At least one of keyword and categoryId must be provided. 0 means all departments. For example: 976759_976787 means \"Cookies\"",
                    "example": "976759_976787"
                  },
                  "sort": {
                    "type": "string",
                    "description": "Sort method. Options: price_low (price low to high), price_high (price high to low), best_seller (best seller), best_match (best match)"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number for pagination, default 1, max 100",
                    "example": 1
                  },
                  "minPrice": {
                    "type": "number",
                    "description": "Minimum price",
                    "example": 1
                  },
                  "maxPrice": {
                    "type": "number",
                    "description": "Maximum price",
                    "example": 1
                  },
                  "spelling": {
                    "type": "boolean",
                    "description": "Enable spelling correction, default true. true includes spelling correction, false excludes it",
                    "example": false
                  },
                  "softSort": {
                    "type": "boolean",
                    "description": "Sort by relevance, default true. Set to false to disable relevance sorting",
                    "example": false
                  },
                  "storeId": {
                    "type": "string",
                    "description": "Store ID, used to filter products by a specific store",
                    "example": "example-id"
                  },
                  "device": {
                    "type": "string",
                    "description": "Device type, default desktop. Options: desktop, tablet, mobile"
                  },
                  "facet": {
                    "type": "string",
                    "description": "Filter conditions, format as key:value pairs separated by \\"
                  },
                  "nextDayEnabled": {
                    "type": "boolean",
                    "description": "Only show NextDay delivery results, default false. true to enable, false to disable",
                    "example": false
                  },
                  "jsonRestrictor": {
                    "type": "string",
                    "description": "JSON field restrictor"
                  }
                },
                "example": {
                  "page": 1,
                  "keyword": "phone case",
                  "spelling": true
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "keyword": "phone case",
                "spelling": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Record count",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "products": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Product list (see product object below)",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "productId": {
                                        "type": "string",
                                        "description": "Product ID",
                                        "example": "example-id"
                                      },
                                      "usItemId": {
                                        "type": "string",
                                        "description": "US item ID",
                                        "example": "example-id"
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Title",
                                        "example": null
                                      },
                                      "description": {
                                        "type": "string",
                                        "description": "Description",
                                        "example": null
                                      },
                                      "price": {
                                        "type": "number",
                                        "description": "Price",
                                        "example": 1
                                      },
                                      "wasPrice": {
                                        "type": "number",
                                        "description": "Original price (was_price)",
                                        "example": 1
                                      },
                                      "currency": {
                                        "type": "string",
                                        "description": "Currency unit",
                                        "example": null
                                      },
                                      "minPrice": {
                                        "type": "number",
                                        "description": "Minimum price",
                                        "example": 1
                                      },
                                      "pricePerUnitAmount": {
                                        "type": "string",
                                        "description": "Price per unit amount",
                                        "example": null
                                      },
                                      "pricePerUnit": {
                                        "type": "string",
                                        "description": "Price per unit",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Rating",
                                        "example": 1
                                      },
                                      "reviews": {
                                        "type": "integer",
                                        "description": "Review count",
                                        "example": 1
                                      },
                                      "sellerName": {
                                        "type": "string",
                                        "description": "Seller name",
                                        "example": null
                                      },
                                      "sellerId": {
                                        "type": "string",
                                        "description": "Seller ID",
                                        "example": "example-id"
                                      },
                                      "imageUrl": {
                                        "type": "string",
                                        "description": "Thumbnail",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "productPageUrl": {
                                        "type": "string",
                                        "description": "Product page URL",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "sponsored": {
                                        "type": "boolean",
                                        "description": "Whether a sponsored product",
                                        "example": false
                                      },
                                      "outOfStock": {
                                        "type": "boolean",
                                        "description": "Whether out of stock",
                                        "example": false
                                      },
                                      "freeShipping": {
                                        "type": "boolean",
                                        "description": "Whether free shipping",
                                        "example": false
                                      },
                                      "twoDayShipping": {
                                        "type": "boolean",
                                        "description": "Whether two-day shipping supported",
                                        "example": false
                                      },
                                      "freeShippingWithWalmartPlus": {
                                        "type": "boolean",
                                        "description": "Free shipping for Walmart Plus members",
                                        "example": false
                                      },
                                      "shippingPrice": {
                                        "type": "number",
                                        "description": "Shipping cost",
                                        "example": 1
                                      },
                                      "multipleOptionsAvailable": {
                                        "type": "boolean",
                                        "description": "Whether multiple options available",
                                        "example": false
                                      },
                                      "variantSwatches": {
                                        "type": "array",
                                        "description": "Variant swatch list (each item contains name variant name, imageUrl variant image URL, productPageUrl variant product page URL, variantFieldId variant field ID)",
                                        "example": []
                                      },
                                      "sourceTool": {
                                        "type": "string",
                                        "description": "Source tool",
                                        "example": null
                                      },
                                      "sourceType": {
                                        "type": "string",
                                        "description": "Source type: walmart",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Rendered columns",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "products": [
                      {
                        "productId": "example-id",
                        "usItemId": "example-id",
                        "price": 1,
                        "wasPrice": 1,
                        "minPrice": 1,
                        "rating": 1,
                        "reviews": 1,
                        "sellerId": "example-id",
                        "imageUrl": "https://example.com/image.jpg",
                        "productPageUrl": "https://example.com/image.jpg",
                        "sponsored": false,
                        "outOfStock": false,
                        "freeShipping": false,
                        "twoDayShipping": false,
                        "freeShippingWithWalmartPlus": false,
                        "shippingPrice": 1,
                        "multipleOptionsAvailable": false,
                        "variantSwatches": []
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "walmart-search",
        "x-nexscope-mcp-tool-name": "nexscope_walmart_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/amazon-alexa-search/run": {
      "post": {
        "tags": [
          "Amazon Marketplace Intelligence"
        ],
        "summary": "Amazon Alexa Search",
        "description": "Initiate natural language Q&A through Amazon's storefront Alexa shopping assistant to get shopping guidance answers, recommended product groups, ASIN lists, and follow-up questions. Each call supports only 1 prompt; for follow-ups, the agent must summarize context and concatenate a new question for a new request. A url can be used to supplement Amazon page context. Trigger when the user mentions Amazon Alexa, Alexa shopping assistant, Amazon smart assistant, AI shopping guide, conversational product selection, natural language shopping, Amazon chat Q&A, Amazon Alexa shopping, conversational shopping, AI shopping assistant, follow-up questions, product recommendation conversation, context follow-ups. Even if the user does not explicitly mention \"Alexa\", if their need is to \"ask for product recommendations on Amazon using natural language\", this skill should also be triggered.",
        "operationId": "runAmazonAlexaSearch",
        "externalDocs": {
          "description": "Amazon Alexa Search documentation",
          "url": "https://www.nexscope.ai/api-docs/amazon-alexa-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.amazon-alexa-search.",
                "properties": {
                  "prompts": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Conversation prompt array, supports only 1 entry. Each call accepts only 1 question. For follow-up questions, the agent must summarize key information from the previous response (recommended products, ASINs, key conclusions, etc.), concatenate it with the new question, and send it as a new prompts[0]. Each call is an independent new session and does not retain cross-call conversation history",
                    "example": [
                      "What are good phone cases for iPhone?"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "Response format: markdown (default) returns a readable report; json returns a structured data array"
                  },
                  "url": {
                    "type": "string",
                    "description": "Linked page URL, used to supplement the page context of Alexa's current response. Only pass this when the user provides a specific page (category page / search results page / product detail page, etc.); do not pass this parameter for the Amazon homepage (e.g. https://www.amazon.com/)",
                    "example": "https://example.com/image.jpg"
                  }
                },
                "required": [
                  "prompts"
                ],
                "example": {
                  "prompts": [
                    "What are good phone cases for iPhone?"
                  ],
                  "format": "markdown"
                },
                "additionalProperties": true
              },
              "example": {
                "prompts": [
                  "What are good phone cases for iPhone?"
                ],
                "format": "markdown"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Structured conversation result array; only returned when format=json",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "stdout": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "description": "Markdown format Q&A report, containing each round's user question, Alexa answer, recommended products, and follow-up questions; only returned when format=markdown",
                                            "example": null
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "prompt": {
                                        "type": "string",
                                        "description": "Prompt sent to Alexa for this round",
                                        "example": null
                                      },
                                      "content": {
                                        "type": "string",
                                        "description": "Text content of Alexa's response for this round",
                                        "example": null
                                      },
                                      "screenshot": {
                                        "type": "string",
                                        "description": "Screenshot link for this round's conversation",
                                        "example": null
                                      },
                                      "followUpQuestions": {
                                        "type": "array",
                                        "description": "List of follow-up questions recommended by Alexa",
                                        "example": []
                                      },
                                      "products": {
                                        "type": "array",
                                        "description": "Recommended product group list, each group containing title and items",
                                        "example": [],
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "title": {
                                              "type": "string",
                                              "description": "Recommended group title",
                                              "example": null
                                            },
                                            "items": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "asin": {
                                                    "type": "string",
                                                    "description": "Product ASIN",
                                                    "example": "B072MQ5BRX"
                                                  },
                                                  "title": {
                                                    "type": "string",
                                                    "description": "Product title",
                                                    "example": null
                                                  },
                                                  "url": {
                                                    "type": "string",
                                                    "description": "Product detail page URL",
                                                    "example": "https://www.amazon.com/dp/B072MQ5BRX"
                                                  },
                                                  "cover": {
                                                    "type": "string",
                                                    "description": "Product cover image URL",
                                                    "example": null
                                                  },
                                                  "price": {
                                                    "type": "string",
                                                    "description": "Current price (with currency)",
                                                    "example": null
                                                  },
                                                  "originalPrice": {
                                                    "type": "string",
                                                    "description": "Original or strikethrough price",
                                                    "example": null
                                                  },
                                                  "score": {
                                                    "type": "string",
                                                    "description": "Rating",
                                                    "example": null
                                                  },
                                                  "ratingsCount": {
                                                    "type": "string",
                                                    "description": "Review count",
                                                    "example": null
                                                  },
                                                  "describe": {
                                                    "type": "string",
                                                    "description": "Product description",
                                                    "example": null
                                                  }
                                                }
                                              }
                                            }
                                          }
                                        }
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "resultsNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of conversation rounds Alexa actually answered; 0 means no valid response was produced",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "API latency in milliseconds",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed by this call; charged only if upstream succeeds",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "taskId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Task identifier returned by upstream",
                                  "example": "example-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style: stdoutWorkbenches (markdown) or json",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "data": [
                      {
                        "followUpQuestions": [],
                        "products": [
                          {
                            "items": [
                              {
                                "asin": "B072MQ5BRX",
                                "url": "https://www.amazon.com/dp/B072MQ5BRX"
                              }
                            ]
                          }
                        ]
                      }
                    ],
                    "resultsNum": 1,
                    "costTime": 1,
                    "costToken": 1,
                    "taskId": "example-id"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "amazon-alexa-search",
        "x-nexscope-mcp-tool-name": "nexscope_amazon_alexa_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/web-search/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "Web Search",
        "description": "Web search, online retrieval, real-time information query, search engine search, Reddit and other community platform discussions, external site posts and trending topics. Trigger when users need to search for the latest information online, look up recent news or trends, query real-time data, research topics via search engines, browse Reddit or community discussions, discover external site posts and trending topics, obtain any online content, web search, online lookup, real-time information, news search, Reddit, trending topics, search engine. Even if the user does not explicitly say \"search\", trigger this skill whenever their intent involves obtaining real-time web information or verifying current facts.",
        "operationId": "runWebSearch",
        "externalDocs": {
          "description": "Web Search documentation",
          "url": "https://www.nexscope.ai/api-docs/web-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.web-search.",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "description": "Search keyword, max length 1000 characters",
                    "example": "phone case"
                  }
                },
                "required": [
                  "keyword"
                ],
                "example": {
                  "keyword": "phone case"
                },
                "additionalProperties": true
              },
              "example": {
                "keyword": "phone case"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "searchList": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Search result list",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "score": {
                                        "type": "number",
                                        "description": "Result relevance score",
                                        "example": 1
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Page title",
                                        "example": null
                                      },
                                      "url": {
                                        "type": "string",
                                        "description": "Page link",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "content": {
                                        "type": "string",
                                        "description": "Extracted page content",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Token cost",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific render or payload type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "searchList": [
                      {
                        "score": 1,
                        "url": "https://example.com/image.jpg"
                      }
                    ],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "web-search",
        "x-nexscope-mcp-tool-name": "nexscope_web_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/zhihuiya-patent-image-search/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Nexscope Patent Image Search",
        "description": "Perform visual similarity search for design patents using an image URL, with filtering by country, legal status, date ranges, Locarno classification, and assignee. Supports design patent types only (type D). Triggered when users mention patent image search, design patent search, search patent by image, visual patent lookup, patent similarity detection, patent image matching, or design patent infringement check. Even if the user does not explicitly mention \"patent image,\" this skill should be triggered whenever the need involves searching for similar design patents through an image. For utility model patents, use ecommerce.zhihuiya-utility-patent-image-search instead.",
        "operationId": "runZhihuiyaPatentImageSearch",
        "externalDocs": {
          "description": "Nexscope Patent Image Search documentation",
          "url": "https://www.nexscope.ai/api-docs/zhihuiya-patent-image-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.zhihuiya-patent-image-search.",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "Image URL (maximum 1,000 characters)",
                    "example": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
                  },
                  "patentType": {
                    "type": "string",
                    "description": "Patent type: D for a design patent or U for a utility model patent. Default: D",
                    "example": "D"
                  },
                  "model": {
                    "type": "integer",
                    "description": "Image-search model. Design patents: 1 (smart association, recommended) or 2 (search this image). Utility model patents: 3 (match shape) or 4 (match shape, pattern, and color; recommended)",
                    "example": 1
                  },
                  "country": {
                    "type": "string",
                    "description": "Patent authority codes for countries, organizations, or regions, separated by commas, for example CN,US,JP. Omit to search all patent authorities"
                  },
                  "loc": {
                    "type": "string",
                    "description": "LOC classifications (Locarno classification numbers). Join multiple classifications with AND, OR, or NOT"
                  },
                  "legalStatus": {
                    "type": "string",
                    "description": "Comma-separated patent legal-status codes. Values: 1 (published), 2 (substantive examination), 3 (granted), 8 (duplicate-grant avoidance), 11 (withdrawn), 12 (withdrawn-unspecified), 17 (deemed withdrawn), 18 (voluntarily withdrawn), 13 (rejected), 14 (fully revoked), 15 (expired), 16 (annual fee unpaid), 21 (rights restored), 22 (rights terminated), 23 (partially invalid), 24 (application terminated), 30 (abandoned), 19 (deemed abandoned), 20 (voluntarily abandoned), 25 (abandoned-unspecified), 222 (PCT did not enter designated state within designation period), 223 (PCT entered designated state within designation period), 224 (PCT entered designated state after designation period), and 225 (PCT did not enter designated state after designation period)"
                  },
                  "simpleLegalStatus": {
                    "type": "string",
                    "description": "Comma-separated simplified patent legal-status codes. Values: 0 (inactive), 1 (active), 2 (pending), 220 (PCT designation period expired), 221 (within PCT designation period), and 999 (unconfirmed)"
                  },
                  "assignees": {
                    "type": "string",
                    "description": "Applicant or patent owner (maximum 1,000 characters)"
                  },
                  "applyStartTime": {
                    "type": "string",
                    "description": "Patent application start date in yyyyMMdd format"
                  },
                  "applyEndTime": {
                    "type": "string",
                    "description": "Patent application end date in yyyyMMdd format"
                  },
                  "publicStartTime": {
                    "type": "string",
                    "description": "Patent publication start date in yyyyMMdd format"
                  },
                  "publicEndTime": {
                    "type": "string",
                    "description": "Patent publication end date in yyyyMMdd format"
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Number of patents to return, from 1 to 100. Default: 10",
                    "example": 5
                  },
                  "offset": {
                    "type": "integer",
                    "description": "Result offset, from 0 to 1,000. Default: 0",
                    "example": 0
                  },
                  "field": {
                    "type": "string",
                    "description": "Result sort field: SCORE (relevance), APD (application date), PBD (publication date), or ISD (grant date). Default: SCORE"
                  },
                  "order": {
                    "type": "string",
                    "description": "Available when field is APD, PBD, or ISD: desc (descending) or asc (ascending). Default: desc"
                  },
                  "lang": {
                    "type": "string",
                    "description": "Preferred title language: original (original patent title), cn (Chinese-translated title), or en (English-translated title). Default: original"
                  },
                  "preFilter": {
                    "type": "integer",
                    "description": "Whether to enable country/LOC pre-filtering: 1 for enabled and 0 for disabled. Default: 1",
                    "example": 1
                  },
                  "stemming": {
                    "type": "integer",
                    "description": "Whether to enable stemming: 1 for enabled and 0 for disabled. Default: 0",
                    "example": 0
                  },
                  "mainField": {
                    "type": "string",
                    "description": "Primary patent fields, including title, abstract, claims, specification, publication number, application number, applicant, inventor, and IPC/UPC/LOC classifications (maximum 1,000 characters)"
                  },
                  "includeMachineTranslation": {
                    "type": "boolean",
                    "description": "Include machine-translated data in the search",
                    "example": false
                  },
                  "scoreExpansion": {
                    "type": "boolean",
                    "description": "Score expansion",
                    "example": false
                  },
                  "isHttps": {
                    "type": "integer",
                    "description": "Whether to return images over HTTPS: 1 for HTTPS and 0 for HTTP. Default: 0",
                    "example": 1
                  },
                  "returnImgId": {
                    "type": "boolean",
                    "description": "Whether to return img_id. Default: false",
                    "example": false
                  }
                },
                "required": [
                  "url",
                  "patentType",
                  "model"
                ],
                "example": {
                  "country": "US",
                  "url": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
                  "patentType": "D",
                  "model": 1,
                  "preFilter": 1,
                  "isHttps": 1,
                  "limit": 5,
                  "stemming": 0,
                  "offset": 0
                },
                "additionalProperties": true
              },
              "example": {
                "country": "US",
                "url": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
                "patentType": "D",
                "model": 1,
                "preFilter": 1,
                "isHttps": 1,
                "limit": 5,
                "stemming": 0,
                "offset": 0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records returned in this response",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "allRecordsCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matching records in the database",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Matching patent records",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Similar patent ID",
                                        "example": "example-id"
                                      },
                                      "patentPn": {
                                        "type": "string",
                                        "description": "Similar patent number",
                                        "example": null
                                      },
                                      "apno": {
                                        "type": "string",
                                        "description": "Application number",
                                        "example": null
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Patent title",
                                        "example": null
                                      },
                                      "inventor": {
                                        "type": "string",
                                        "description": "Inventor",
                                        "example": null
                                      },
                                      "originalAssignee": {
                                        "type": "string",
                                        "description": "Original assignee",
                                        "example": null
                                      },
                                      "currentAssignee": {
                                        "type": "string",
                                        "description": "Current assignee",
                                        "example": null
                                      },
                                      "authority": {
                                        "type": "string",
                                        "description": "Patent authority (country code)",
                                        "example": null
                                      },
                                      "url": {
                                        "type": "string",
                                        "description": "URL of the similar patent drawing",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "score": {
                                        "type": "number",
                                        "description": "Similarity score; higher values indicate greater similarity. Available only when field is SCORE",
                                        "example": 1
                                      },
                                      "loc": {
                                        "type": "array",
                                        "description": "LOC classification (Locarno classification number)",
                                        "example": []
                                      },
                                      "locMatch": {
                                        "type": "integer",
                                        "description": "Whether a high-weight LOC class matched: 1 for matched and 0 for not matched. Available only when model=1 and field=SCORE",
                                        "example": 1
                                      },
                                      "apdt": {
                                        "type": "integer",
                                        "description": "Application date (timestamp)",
                                        "example": 1
                                      },
                                      "pbdt": {
                                        "type": "integer",
                                        "description": "Publication date (timestamp)",
                                        "example": 1
                                      },
                                      "imgId": {
                                        "type": "string",
                                        "description": "Patent drawing img_id, returned only when returnImgId is true",
                                        "example": "example-id"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions used for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendering style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "allRecordsCount": 1,
                    "data": [
                      {
                        "patentId": "example-id",
                        "url": "https://example.com/image.jpg",
                        "score": 1,
                        "loc": [],
                        "locMatch": 1,
                        "apdt": 1,
                        "pbdt": 1,
                        "imgId": "example-id"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "zhihuiya-patent-image-search",
        "x-nexscope-mcp-tool-name": "nexscope_zhihuiya_patent_image_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/zhihuiya-utility-patent-image-search/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Nexscope Utility Patent Image Search",
        "description": "Perform visual similarity search for utility model patents using an image URL, with filtering by country, legal status, date ranges, and assignee. Supports utility model patents only (type U) with shape-only or shape+pattern+color matching models. Triggered when users mention utility patent image search, utility model patent search, utility patent infringement check, product structure patent search, or utility model visual search. Even if the user does not explicitly mention \"utility patent,\" this skill should be triggered whenever the need involves searching for similar utility model patents through an image. For design patents, use ecommerce.zhihuiya-patent-image-search instead.",
        "operationId": "runZhihuiyaUtilityPatentImageSearch",
        "externalDocs": {
          "description": "Nexscope Utility Patent Image Search documentation",
          "url": "https://www.nexscope.ai/api-docs/zhihuiya-utility-patent-image-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Request parameters documented by ecommerce.zhihuiya-utility-patent-image-search.",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "Image URL (maximum 1,000 characters)",
                    "example": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"
                  },
                  "patentType": {
                    "type": "string",
                    "description": "Patent type: U for a utility model patent. Default: U",
                    "example": "U"
                  },
                  "model": {
                    "type": "integer",
                    "description": "Image-search model. Design patents: 1 (smart association, recommended) or 2 (search this image). Utility model patents: 3 (match shape) or 4 (match shape, pattern, and color; recommended)",
                    "example": 4
                  },
                  "country": {
                    "type": "string",
                    "description": "Patent authority codes for countries, organizations, or regions, separated by commas, for example CN,US,JP. Omit to search all patent authorities"
                  },
                  "loc": {
                    "type": "string",
                    "description": "LOC classifications (Locarno classification numbers). Join multiple classifications with AND, OR, or NOT"
                  },
                  "legalStatus": {
                    "type": "string",
                    "description": "Comma-separated patent legal-status codes. Values: 1 (published), 2 (substantive examination), 3 (granted), 8 (duplicate-grant avoidance), 11 (withdrawn), 12 (withdrawn-unspecified), 17 (deemed withdrawn), 18 (voluntarily withdrawn), 13 (rejected), 14 (fully revoked), 15 (expired), 16 (annual fee unpaid), 21 (rights restored), 22 (rights terminated), 23 (partially invalid), 24 (application terminated), 30 (abandoned), 19 (deemed abandoned), 20 (voluntarily abandoned), 25 (abandoned-unspecified), 222 (PCT did not enter designated state within designation period), 223 (PCT entered designated state within designation period), 224 (PCT entered designated state after designation period), and 225 (PCT did not enter designated state after designation period)"
                  },
                  "simpleLegalStatus": {
                    "type": "string",
                    "description": "Comma-separated simplified patent legal-status codes. Values: 0 (inactive), 1 (active), 2 (pending), 220 (PCT designation period expired), 221 (within PCT designation period), and 999 (unconfirmed)"
                  },
                  "assignees": {
                    "type": "string",
                    "description": "Applicant or patent owner (maximum 1,000 characters)"
                  },
                  "applyStartTime": {
                    "type": "string",
                    "description": "Patent application start date in yyyyMMdd format"
                  },
                  "applyEndTime": {
                    "type": "string",
                    "description": "Patent application end date in yyyyMMdd format"
                  },
                  "publicStartTime": {
                    "type": "string",
                    "description": "Patent publication start date in yyyyMMdd format"
                  },
                  "publicEndTime": {
                    "type": "string",
                    "description": "Patent publication end date in yyyyMMdd format"
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Number of patents to return, from 1 to 100. Default: 10",
                    "example": 5
                  },
                  "offset": {
                    "type": "integer",
                    "description": "Result offset, from 0 to 1,000. Default: 0",
                    "example": 0
                  },
                  "field": {
                    "type": "string",
                    "description": "Result sort field: SCORE (relevance), APD (application date), PBD (publication date), or ISD (grant date). Default: SCORE"
                  },
                  "order": {
                    "type": "string",
                    "description": "Available when field is APD, PBD, or ISD: desc (descending) or asc (ascending). Default: desc"
                  },
                  "lang": {
                    "type": "string",
                    "description": "Preferred title language: original (original patent title), cn (Chinese-translated title), or en (English-translated title). Default: original"
                  },
                  "preFilter": {
                    "type": "integer",
                    "description": "Whether to enable country/LOC pre-filtering: 1 for enabled and 0 for disabled. Default: 1",
                    "example": 1
                  },
                  "stemming": {
                    "type": "integer",
                    "description": "Whether to enable stemming: 1 for enabled and 0 for disabled. Default: 0",
                    "example": 0
                  },
                  "mainField": {
                    "type": "string",
                    "description": "Primary patent fields, including title, abstract, claims, specification, publication number, application number, applicant, inventor, and IPC/UPC/LOC classifications (maximum 1,000 characters)"
                  },
                  "includeMachineTranslation": {
                    "type": "boolean",
                    "description": "Include machine-translated data in the search",
                    "example": false
                  },
                  "scoreExpansion": {
                    "type": "boolean",
                    "description": "Score expansion",
                    "example": false
                  },
                  "isHttps": {
                    "type": "integer",
                    "description": "Whether to return images over HTTPS: 1 for HTTPS and 0 for HTTP. Default: 0",
                    "example": 1
                  },
                  "returnImgId": {
                    "type": "boolean",
                    "description": "Whether to return img_id. Default: false",
                    "example": false
                  }
                },
                "required": [
                  "url",
                  "patentType",
                  "model"
                ],
                "example": {
                  "country": "US",
                  "url": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
                  "patentType": "U",
                  "model": 4,
                  "preFilter": 1,
                  "isHttps": 1,
                  "limit": 5,
                  "stemming": 0,
                  "offset": 0
                },
                "additionalProperties": true
              },
              "example": {
                "country": "US",
                "url": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
                "patentType": "U",
                "model": 4,
                "preFilter": 1,
                "isHttps": 1,
                "limit": 5,
                "stemming": 0,
                "offset": 0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of records returned in this response",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "allRecordsCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total number of matching records in the database",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Matching patent records",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "patentId": {
                                        "type": "string",
                                        "description": "Similar patent ID",
                                        "example": "example-id"
                                      },
                                      "patentPn": {
                                        "type": "string",
                                        "description": "Similar patent number",
                                        "example": null
                                      },
                                      "apno": {
                                        "type": "string",
                                        "description": "Application number",
                                        "example": null
                                      },
                                      "title": {
                                        "type": "string",
                                        "description": "Patent title",
                                        "example": null
                                      },
                                      "inventor": {
                                        "type": "string",
                                        "description": "Inventor",
                                        "example": null
                                      },
                                      "originalAssignee": {
                                        "type": "string",
                                        "description": "Original assignee",
                                        "example": null
                                      },
                                      "currentAssignee": {
                                        "type": "string",
                                        "description": "Current assignee",
                                        "example": null
                                      },
                                      "authority": {
                                        "type": "string",
                                        "description": "Patent authority (country code)",
                                        "example": null
                                      },
                                      "url": {
                                        "type": "string",
                                        "description": "URL of the similar patent drawing",
                                        "example": "https://example.com/image.jpg"
                                      },
                                      "score": {
                                        "type": "number",
                                        "description": "Similarity score; higher values indicate greater similarity. Available only when field is SCORE",
                                        "example": 1
                                      },
                                      "loc": {
                                        "type": "array",
                                        "description": "LOC classification (Locarno classification number)",
                                        "example": []
                                      },
                                      "locMatch": {
                                        "type": "integer",
                                        "description": "Whether a high-weight LOC class matched: 1 for matched and 0 for not matched. Available only when model=1 and field=SCORE",
                                        "example": 1
                                      },
                                      "apdt": {
                                        "type": "integer",
                                        "description": "Application date (timestamp)",
                                        "example": 1
                                      },
                                      "pbdt": {
                                        "type": "integer",
                                        "description": "Publication date (timestamp)",
                                        "example": 1
                                      },
                                      "imgId": {
                                        "type": "string",
                                        "description": "Patent drawing img_id, returned only when returnImgId is true",
                                        "example": "example-id"
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Column definitions used for rendering",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Rendering style",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Tokens consumed",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "allRecordsCount": 1,
                    "data": [
                      {
                        "patentId": "example-id",
                        "url": "https://example.com/image.jpg",
                        "score": 1,
                        "loc": [],
                        "locMatch": 1,
                        "apdt": 1,
                        "pbdt": 1,
                        "imgId": "example-id"
                      }
                    ],
                    "columns": [],
                    "costToken": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "zhihuiya-utility-patent-image-search",
        "x-nexscope-mcp-tool-name": "nexscope_zhihuiya_utility_patent_image_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-model-swap/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Model Swap API",
        "description": "Generate model images by combining a source product image with a model head image, optional masks, scene references, and prompt guidance.",
        "operationId": "runAiModelSwap",
        "externalDocs": {
          "description": "AI Model Swap API documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-model-swap"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate model images by combining a source product image with a model head image, optional masks, scene references, and prompt guidance.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the source product or outfit image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "modelHeadImageUrl": {
                    "type": "string",
                    "description": "Public URL of the target model head image. The image must be up to 5 MB and between 512 and 2048 pixels in both width and height.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "imageSegUrl": {
                    "type": "string",
                    "description": "Optional segmentation mask URL for the source image.",
                    "example": "https://example.com/mask.png"
                  },
                  "sceneImgUrl": {
                    "type": "string",
                    "description": "Optional scene reference image URL. The image must be up to 10 MB and between 768 and 4096 pixels in both width and height.",
                    "example": "https://example.com/scene.jpg"
                  },
                  "sceneStrength": {
                    "type": "number",
                    "description": "Scene reference strength from 0 to 1. Defaults to 0.7.",
                    "example": 0.7
                  },
                  "modelPrompt": {
                    "type": "string",
                    "description": "Comma-separated model appearance terms, such as smile, laugh, sitting, lying, fat, plump, slim, sideways, profile, back, or bald.",
                    "example": "smile, slim"
                  },
                  "customPrompt": {
                    "type": "string",
                    "description": "Positive generation prompt, up to 600 characters.",
                    "example": "clean ecommerce catalog photo"
                  },
                  "customNegPrompt": {
                    "type": "string",
                    "description": "Negative prompt to avoid unwanted artifacts.",
                    "example": "blur, distorted hands"
                  },
                  "genOriRes": {
                    "type": "boolean",
                    "description": "Whether to generate the original resolution. Defaults to false.",
                    "example": false
                  },
                  "realModel": {
                    "type": "boolean",
                    "description": "Whether to prefer a realistic model style.",
                    "example": true
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl",
                  "modelHeadImageUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/source-image.jpg",
                  "modelHeadImageUrl": "https://example.com/model-reference.jpg",
                  "imageSegUrl": "https://example.com/mask.png",
                  "sceneImgUrl": "https://example.com/scene.jpg",
                  "sceneStrength": 0.7,
                  "modelPrompt": "smile, slim",
                  "customPrompt": "clean ecommerce catalog photo",
                  "customNegPrompt": "blur, distorted hands",
                  "genOriRes": false,
                  "realModel": true,
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/source-image.jpg",
                "modelHeadImageUrl": "https://example.com/model-reference.jpg",
                "imageSegUrl": "https://example.com/mask.png",
                "sceneImgUrl": "https://example.com/scene.jpg",
                "sceneStrength": 0.7,
                "modelPrompt": "smile, slim",
                "customPrompt": "clean ecommerce catalog photo",
                "customNegPrompt": "blur, distorted hands",
                "genOriRes": false,
                "realModel": true,
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-model-swap",
        "x-nexscope-mcp-tool-name": "nexscope_ai_model_swap",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-model-swap-2-0/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Model Swap API 2.0",
        "description": "Generate model images from a product image and a full model reference image with optional segmentation and scene controls.",
        "operationId": "runAiModelSwap20",
        "externalDocs": {
          "description": "AI Model Swap API 2.0 documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-model-swap-2-0"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate model images from a product image and a full model reference image with optional segmentation and scene controls.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the source product or outfit image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "modelImageUrl": {
                    "type": "string",
                    "description": "Public URL of the full model reference image.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  },
                  "imageSegUrl": {
                    "type": "string",
                    "description": "Optional segmentation mask URL for the source image.",
                    "example": "https://example.com/mask.png"
                  },
                  "sceneImgUrl": {
                    "type": "string",
                    "description": "Optional scene reference image URL.",
                    "example": "https://example.com/scene.jpg"
                  },
                  "sceneStrength": {
                    "type": "number",
                    "description": "Scene reference strength from 0 to 1. Defaults to 0.7.",
                    "example": 0.7
                  },
                  "genOriRes": {
                    "type": "boolean",
                    "description": "Whether to generate the original resolution. Defaults to false.",
                    "example": false
                  },
                  "realModel": {
                    "type": "boolean",
                    "description": "Whether to prefer a realistic model style.",
                    "example": true
                  }
                },
                "required": [
                  "imageUrl",
                  "modelImageUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/source-image.jpg",
                  "modelImageUrl": "https://example.com/model-reference.jpg",
                  "outputNum": 1,
                  "imageSegUrl": "https://example.com/mask.png",
                  "sceneImgUrl": "https://example.com/scene.jpg",
                  "sceneStrength": 0.7,
                  "genOriRes": false,
                  "realModel": true
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/source-image.jpg",
                "modelImageUrl": "https://example.com/model-reference.jpg",
                "outputNum": 1,
                "imageSegUrl": "https://example.com/mask.png",
                "sceneImgUrl": "https://example.com/scene.jpg",
                "sceneStrength": 0.7,
                "genOriRes": false,
                "realModel": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-model-swap-2-0",
        "x-nexscope-mcp-tool-name": "nexscope_ai_model_swap_2_0",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-model-scene-background-replacement/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Model Scene & Background Replacement API",
        "description": "Generate scene variants for a model image using either a scene reference image or a text scene prompt.",
        "operationId": "runAiModelSceneBackgroundReplacement",
        "externalDocs": {
          "description": "AI Model Scene & Background Replacement API documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-model-scene-background-replacement"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate scene variants for a model image using either a scene reference image or a text scene prompt.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the model image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "sceneImgUrl": {
                    "type": "string",
                    "description": "Optional public URL of the target scene reference.",
                    "example": "https://example.com/scene.jpg"
                  },
                  "scenePrompt": {
                    "type": "string",
                    "description": "Optional text prompt describing the target scene.",
                    "example": "bright studio showroom"
                  },
                  "imageSegUrl": {
                    "type": "string",
                    "description": "Optional model segmentation mask URL.",
                    "example": "https://example.com/mask.png"
                  },
                  "sceneStrength": {
                    "type": "number",
                    "description": "Scene reference strength from 0 to 1. Defaults to 0.7.",
                    "example": 0.7
                  },
                  "genOriRes": {
                    "type": "boolean",
                    "description": "Whether to generate the original resolution. Defaults to false.",
                    "example": false
                  },
                  "realModel": {
                    "type": "boolean",
                    "description": "Whether to prefer realistic model rendering.",
                    "example": true
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/model-reference.jpg",
                  "scenePrompt": "bright studio showroom",
                  "sceneStrength": 0.7,
                  "genOriRes": false,
                  "realModel": true,
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/model-reference.jpg",
                "scenePrompt": "bright studio showroom",
                "sceneStrength": 0.7,
                "genOriRes": false,
                "realModel": true,
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-model-scene-background-replacement",
        "x-nexscope-mcp-tool-name": "nexscope_ai_model_scene_background_replacement",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-clothes-changer-for-tops-bottoms/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Clothes Changer API for Tops & Bottoms",
        "description": "Dress a model image with upper and/or lower garment assets, supporting optional masks and original garment references.",
        "operationId": "runAiClothesChangerForTopsBottoms",
        "externalDocs": {
          "description": "AI Clothes Changer API for Tops & Bottoms documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-clothes-changer-for-tops-bottoms"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Dress a model image with upper and/or lower garment assets, supporting optional masks and original garment references.",
                "properties": {
                  "modelImageUrl": {
                    "type": "string",
                    "description": "Public URL of the model image.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "upperOriginUrl": {
                    "type": "string",
                    "description": "Public URL of the original upper garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.",
                    "example": "https://example.com/top.jpg"
                  },
                  "downOriginUrl": {
                    "type": "string",
                    "description": "Public URL of the original lower garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.",
                    "example": "https://example.com/bottom.jpg"
                  },
                  "upperImageUrl": {
                    "type": "string",
                    "description": "Optional processed upper garment mask or crop URL.",
                    "example": "https://example.com/top-mask.png"
                  },
                  "downImageUrl": {
                    "type": "string",
                    "description": "Optional processed lower garment mask or crop URL.",
                    "example": "https://example.com/bottom-mask.png"
                  },
                  "modelMaskImageUrl": {
                    "type": "string",
                    "description": "Optional mask URL for the model body area.",
                    "example": "https://example.com/mask.png"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "modelImageUrl"
                ],
                "example": {
                  "modelImageUrl": "https://example.com/model-reference.jpg",
                  "upperOriginUrl": "https://example.com/top.jpg",
                  "downOriginUrl": "https://example.com/bottom.jpg",
                  "upperImageUrl": "https://example.com/top-mask.png",
                  "downImageUrl": "https://example.com/bottom-mask.png",
                  "modelMaskImageUrl": "https://example.com/mask.png",
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "modelImageUrl": "https://example.com/model-reference.jpg",
                "upperOriginUrl": "https://example.com/top.jpg",
                "downOriginUrl": "https://example.com/bottom.jpg",
                "upperImageUrl": "https://example.com/top-mask.png",
                "downImageUrl": "https://example.com/bottom-mask.png",
                "modelMaskImageUrl": "https://example.com/mask.png",
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-clothes-changer-for-tops-bottoms",
        "x-nexscope-mcp-tool-name": "nexscope_ai_clothes_changer_for_tops_bottoms",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-suit-virtual-try-on/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Suit Virtual Try-On API",
        "description": "Dress a model image with a one-piece outfit or suit image, supporting optional garment and model masks.",
        "operationId": "runAiSuitVirtualTryOn",
        "externalDocs": {
          "description": "AI Suit Virtual Try-On API documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-suit-virtual-try-on"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Dress a model image with a one-piece outfit or suit image, supporting optional garment and model masks.",
                "properties": {
                  "suitOriginUrl": {
                    "type": "string",
                    "description": "Public URL of the original one-piece garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.",
                    "example": "https://example.com/suit.jpg"
                  },
                  "modelImageUrl": {
                    "type": "string",
                    "description": "Public URL of the model image.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "suitImageUrl": {
                    "type": "string",
                    "description": "Optional processed suit mask or crop URL.",
                    "example": "https://example.com/suit-mask.png"
                  },
                  "modelMaskImageUrl": {
                    "type": "string",
                    "description": "Optional mask URL for the model body area.",
                    "example": "https://example.com/mask.png"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "suitOriginUrl",
                  "modelImageUrl"
                ],
                "example": {
                  "suitOriginUrl": "https://example.com/suit.jpg",
                  "modelImageUrl": "https://example.com/model-reference.jpg",
                  "suitImageUrl": "https://example.com/suit-mask.png",
                  "modelMaskImageUrl": "https://example.com/mask.png",
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "suitOriginUrl": "https://example.com/suit.jpg",
                "modelImageUrl": "https://example.com/model-reference.jpg",
                "suitImageUrl": "https://example.com/suit-mask.png",
                "modelMaskImageUrl": "https://example.com/mask.png",
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-suit-virtual-try-on",
        "x-nexscope-mcp-tool-name": "nexscope_ai_suit_virtual_try_on",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/virtual-try-on/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Virtual Try-On API",
        "description": "Generate wearable-product imagery from a source person image and target product image.",
        "operationId": "runVirtualTryOn",
        "externalDocs": {
          "description": "Virtual Try-On API documentation",
          "url": "https://www.nexscope.ai/api-docs/virtual-try-on"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate wearable-product imagery from a source person image and target product image.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the wearable product image. The image must be between 300 and 4096 pixels in both width and height. The width-to-height ratio must be between 0.4 and 2.5.",
                    "example": "https://example.com/product.jpg"
                  },
                  "targetOriginUrl": {
                    "type": "string",
                    "description": "Public URL of the person or model image.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "targetMaskUrl": {
                    "type": "string",
                    "description": "Public URL of the black-and-white target wear-area mask. Required because this API accepts custom target images rather than saved upstream materials.",
                    "example": "https://example.com/mask.png"
                  },
                  "productCategory": {
                    "type": "string",
                    "description": "Product category. Supported values: footwear (shoes), luggage (bags), eyewear (glasses), necklace, hat, earring, ring, wristband, watch, headwear, belt, other.",
                    "example": "hat"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl",
                  "targetOriginUrl",
                  "targetMaskUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "targetOriginUrl": "https://example.com/model-reference.jpg",
                  "targetMaskUrl": "https://example.com/mask.png",
                  "productCategory": "hat",
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "targetOriginUrl": "https://example.com/model-reference.jpg",
                "targetMaskUrl": "https://example.com/mask.png",
                "productCategory": "hat",
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "virtual-try-on",
        "x-nexscope-mcp-tool-name": "nexscope_virtual_try_on",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/product-replacement/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Product Replacement API",
        "description": "Use source and target product references to replace product content while preserving scene consistency.",
        "operationId": "runProductReplacement",
        "externalDocs": {
          "description": "Product Replacement API documentation",
          "url": "https://www.nexscope.ai/api-docs/product-replacement"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Use source and target product references to replace product content while preserving scene consistency.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the base image. The image must be up to 20 MB and between 384 and 8192 pixels in both width and height.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "targetOriginUrl": {
                    "type": "string",
                    "description": "Public URL of the replacement product image.",
                    "example": "https://example.com/product.jpg"
                  },
                  "sourceImageUrl": {
                    "type": "string",
                    "description": "Optional source product crop URL.",
                    "example": "https://example.com/source-product.jpg"
                  },
                  "targetImageUrl": {
                    "type": "string",
                    "description": "Optional processed replacement product URL.",
                    "example": "https://example.com/target-product.png"
                  },
                  "denoiseStrength": {
                    "type": "number",
                    "description": "Generation denoise strength from 0 to 1. Defaults to 0.5.",
                    "example": 0.5
                  },
                  "imageOutputWidth": {
                    "type": "integer",
                    "description": "Desired output width in pixels, from 32 to 4096.",
                    "example": 1024
                  },
                  "imageOutputHeight": {
                    "type": "integer",
                    "description": "Desired output height in pixels, from 32 to 4096.",
                    "example": 1024
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl",
                  "targetOriginUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/source-image.jpg",
                  "targetOriginUrl": "https://example.com/product.jpg",
                  "sourceImageUrl": "https://example.com/source-product.jpg",
                  "targetImageUrl": "https://example.com/target-product.png",
                  "denoiseStrength": 0.5,
                  "imageOutputWidth": 1024,
                  "imageOutputHeight": 1024,
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/source-image.jpg",
                "targetOriginUrl": "https://example.com/product.jpg",
                "sourceImageUrl": "https://example.com/source-product.jpg",
                "targetImageUrl": "https://example.com/target-product.png",
                "denoiseStrength": 0.5,
                "imageOutputWidth": 1024,
                "imageOutputHeight": 1024,
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "product-replacement",
        "x-nexscope-mcp-tool-name": "nexscope_product_replacement",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/product-scene-variations/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Product Scene Variations API",
        "description": "Generate multiple ecommerce scene variants from a product image, optional segmentation, and prompt guidance.",
        "operationId": "runProductSceneVariations",
        "externalDocs": {
          "description": "Product Scene Variations API documentation",
          "url": "https://www.nexscope.ai/api-docs/product-scene-variations"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate multiple ecommerce scene variants from a product image, optional segmentation, and prompt guidance.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the product image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.",
                    "example": "https://example.com/product.jpg"
                  },
                  "segImageUrl": {
                    "type": "string",
                    "description": "Optional segmentation mask URL.",
                    "example": "https://example.com/mask.png"
                  },
                  "strength": {
                    "type": "number",
                    "description": "Variation strength from 0.1 to 1. Defaults to 0.5.",
                    "example": 0.5
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Scene generation prompt, up to 600 characters.",
                    "example": "modern kitchen countertop"
                  },
                  "imageOutputWidth": {
                    "type": "integer",
                    "description": "Desired output width in pixels, from 32 to 2048.",
                    "example": 1024
                  },
                  "imageOutputHeight": {
                    "type": "integer",
                    "description": "Desired output height in pixels, from 32 to 2048.",
                    "example": 1024
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "segImageUrl": "https://example.com/mask.png",
                  "strength": 0.5,
                  "prompt": "modern kitchen countertop",
                  "imageOutputWidth": 1024,
                  "imageOutputHeight": 1024,
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "segImageUrl": "https://example.com/mask.png",
                "strength": 0.5,
                "prompt": "modern kitchen countertop",
                "imageOutputWidth": 1024,
                "imageOutputHeight": 1024,
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "product-scene-variations",
        "x-nexscope-mcp-tool-name": "nexscope_product_scene_variations",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-background-generator/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Background Generator API",
        "description": "Create product or lifestyle scene images from text prompts and optional reference images.",
        "operationId": "runAiBackgroundGenerator",
        "externalDocs": {
          "description": "AI Background Generator API documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-background-generator"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Create product or lifestyle scene images from text prompts and optional reference images.",
                "properties": {
                  "prompt": {
                    "type": "string",
                    "description": "Text prompt describing the desired scene.",
                    "example": "a premium phone case on a clean marble desk"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Optional reference image URL.",
                    "example": "https://example.com/product.jpg"
                  },
                  "style": {
                    "type": "string",
                    "description": "Style preset. Supported values: scene-material, portrait-material, ancient-chinese, expressive-sketch, cyberpunk, pixel-illustration, tranquil-ink, anime-line-art, makoto-shinkai, hayao-miyazaki, cg, monochrome-illustration, retro-anime, chibi-character, realistic-oil-painting, c4d-paper-cut, expressive-watercolor, fresh-anime.",
                    "example": "scene-material"
                  },
                  "scale": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 16:9, 9:16. Defaults to 1:1.",
                    "example": "1:1"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 4.",
                    "example": 4
                  }
                },
                "required": [
                  "prompt"
                ],
                "example": {
                  "prompt": "a premium phone case on a clean marble desk",
                  "imageUrl": "https://example.com/product.jpg",
                  "style": "scene-material",
                  "scale": "1:1",
                  "outputNum": 4
                },
                "additionalProperties": true
              },
              "example": {
                "prompt": "a premium phone case on a clean marble desk",
                "imageUrl": "https://example.com/product.jpg",
                "style": "scene-material",
                "scale": "1:1",
                "outputNum": 4
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-background-generator",
        "x-nexscope-mcp-tool-name": "nexscope_ai_background_generator",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/similar-image-variations/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Similar Image Variations API",
        "description": "Generate similar ecommerce images from a reference image with optional prompt and strength controls.",
        "operationId": "runSimilarImageVariations",
        "externalDocs": {
          "description": "Similar Image Variations API documentation",
          "url": "https://www.nexscope.ai/api-docs/similar-image-variations"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate similar ecommerce images from a reference image with optional prompt and strength controls.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of a JPG, PNG, or WEBP reference image up to 10 MB and at most 4096 pixels in both width and height.",
                    "example": "https://example.com/product.jpg"
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Optional prompt for the desired variation, up to 600 characters.",
                    "example": "same product, brighter background"
                  },
                  "weight": {
                    "type": "integer",
                    "description": "Reference image weight from 0 to 2. Defaults to 2.",
                    "example": 2
                  },
                  "width": {
                    "type": "integer",
                    "description": "Desired output width in pixels, from 384 to 4096.",
                    "example": 1024,
                    "minimum": 384,
                    "maximum": 4096
                  },
                  "height": {
                    "type": "integer",
                    "description": "Desired output height in pixels, from 384 to 4096.",
                    "example": 1024,
                    "minimum": 384,
                    "maximum": 4096
                  },
                  "scale": {
                    "type": "string",
                    "description": "Optional aspect ratio. Provide scale or both width and height.",
                    "example": "1:1"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 4.",
                    "example": 4
                  }
                },
                "required": [
                  "imageUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "prompt": "same product, brighter background",
                  "weight": 2,
                  "width": 1024,
                  "height": 1024,
                  "outputNum": 4
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "prompt": "same product, brighter background",
                "weight": 2,
                "width": 1024,
                "height": 1024,
                "outputNum": 4
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "similar-image-variations",
        "x-nexscope-mcp-tool-name": "nexscope_similar_image_variations",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/background-remover/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Background Remover API",
        "description": "Cut out products, people, or clothing from a source image using an upstream background-removal model.",
        "operationId": "runBackgroundRemover",
        "externalDocs": {
          "description": "Background Remover API documentation",
          "url": "https://www.nexscope.ai/api-docs/background-remover"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Cut out products, people, or clothing from a source image using an upstream background-removal model.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the image to cut out. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.",
                    "example": "https://example.com/product.jpg"
                  },
                  "subType": {
                    "type": "integer",
                    "description": "Cutout type. Supported values: 1 (general), 2 (portrait), 3 (product), 9 (apparel), 12 (hair), 13 (face).",
                    "example": 1
                  },
                  "clothClass": {
                    "type": "string",
                    "description": "Apparel classes used only when subType is 9. Multiple values may be comma-separated. Supported values: tops, coat, skirt, pants, bag, shoes, hat.",
                    "example": "tops"
                  }
                },
                "required": [
                  "imageUrl",
                  "subType"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "subType": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "subType": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "background-remover",
        "x-nexscope-mcp-tool-name": "nexscope_background_remover",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/etsy-store-query/run": {
      "post": {
        "tags": [
          "Etsy Marketplace"
        ],
        "summary": "Etsy Store Query",
        "description": "Returns Etsy store profiles and marketplace performance metrics.",
        "operationId": "runEtsyStoreQuery",
        "externalDocs": {
          "description": "Etsy Store Query documentation",
          "url": "https://www.nexscope.ai/api-docs/etsy-store-query"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "All filters are optional. Use searchKey to query a specific store name or URL.",
                "properties": {
                  "searchKey": {
                    "type": "string",
                    "description": "Store name, keyword, or Etsy store URL.",
                    "example": "Lewshop1"
                  },
                  "category": {
                    "type": "string",
                    "description": "Primary store category.",
                    "example": "Jewelry"
                  },
                  "country": {
                    "type": "string",
                    "description": "Store country or region.",
                    "example": "US"
                  },
                  "status": {
                    "type": "integer",
                    "description": "Store status: 1 active, 0 inactive.",
                    "example": 1
                  },
                  "isRaving": {
                    "type": "integer",
                    "description": "Raving store flag: 1 yes.",
                    "example": 1
                  },
                  "isStar": {
                    "type": "integer",
                    "description": "Star store flag: 1 yes.",
                    "example": 1
                  },
                  "beginFavorites": {
                    "type": "integer",
                    "description": "Minimum total favorites.",
                    "example": 0
                  },
                  "endFavorites": {
                    "type": "integer",
                    "description": "Maximum total favorites.",
                    "example": 10000
                  },
                  "beginFavoritesWeekly": {
                    "type": "integer",
                    "description": "Minimum weekly favorites.",
                    "example": 0
                  },
                  "endFavoritesWeekly": {
                    "type": "integer",
                    "description": "Maximum weekly favorites.",
                    "example": 1000
                  },
                  "beginReviews": {
                    "type": "integer",
                    "description": "Minimum total reviews.",
                    "example": 0
                  },
                  "endReviews": {
                    "type": "integer",
                    "description": "Maximum total reviews.",
                    "example": 10000
                  },
                  "beginReviewsWeekly": {
                    "type": "integer",
                    "description": "Minimum weekly reviews.",
                    "example": 0
                  },
                  "endReviewsWeekly": {
                    "type": "integer",
                    "description": "Maximum weekly reviews.",
                    "example": 1000
                  },
                  "beginSales": {
                    "type": "integer",
                    "description": "Minimum total sales.",
                    "example": 0
                  },
                  "endSales": {
                    "type": "integer",
                    "description": "Maximum total sales.",
                    "example": 100000
                  },
                  "beginSalesWeekly": {
                    "type": "integer",
                    "description": "Minimum weekly sales.",
                    "example": 0
                  },
                  "endSalesWeekly": {
                    "type": "integer",
                    "description": "Maximum weekly sales.",
                    "example": 1000
                  },
                  "beginStoreOpenedAt": {
                    "type": "string",
                    "description": "Opening date range start in YYYY-MM-DD format.",
                    "example": "2020-01-01"
                  },
                  "endStoreOpenedAt": {
                    "type": "string",
                    "description": "Opening date range end in YYYY-MM-DD format.",
                    "example": "2026-01-01"
                  },
                  "sortBy": {
                    "type": "integer",
                    "description": "Sort field: 8 total sales, 9 weekly sales, 10 reviews, 11 favorites.",
                    "example": 8
                  },
                  "sortDesc": {
                    "type": "integer",
                    "description": "Sort direction: 1 descending, 0 ascending.",
                    "example": 1
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number starting from 1.",
                    "example": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "description": "Items per page from 1 to 100.",
                    "example": 20
                  }
                },
                "example": {
                  "page": 1,
                  "searchKey": "Lewshop1",
                  "pageSize": 20
                },
                "additionalProperties": true
              },
              "example": {
                "page": 1,
                "searchKey": "Lewshop1",
                "pageSize": 20
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Records returned on the current page.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "storeNum": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total matching stores.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "stores": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Etsy stores.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "storeId": {
                                        "type": "string",
                                        "description": "Store identifier.",
                                        "example": "123456"
                                      },
                                      "storeName": {
                                        "type": "string",
                                        "description": "Store name.",
                                        "example": "Lewshop1"
                                      },
                                      "storeUrl": {
                                        "type": "string",
                                        "description": "Etsy store URL.",
                                        "example": "https://www.etsy.com/shop/Lewshop1"
                                      },
                                      "logoUrl": {
                                        "type": "string",
                                        "description": "Store avatar URL.",
                                        "example": null
                                      },
                                      "shopWebsite": {
                                        "type": "string",
                                        "description": "Store website or external link.",
                                        "example": null
                                      },
                                      "startAt": {
                                        "type": "string",
                                        "description": "Store opening date.",
                                        "example": null
                                      },
                                      "country": {
                                        "type": "array",
                                        "description": "Store countries or regions.",
                                        "example": []
                                      },
                                      "category": {
                                        "type": "array",
                                        "description": "Primary categories.",
                                        "example": []
                                      },
                                      "productCount": {
                                        "type": "integer",
                                        "description": "Store product count.",
                                        "example": null
                                      },
                                      "salesTotal": {
                                        "type": "integer",
                                        "description": "Total sales.",
                                        "example": 1
                                      },
                                      "salesWeekly": {
                                        "type": "integer",
                                        "description": "Weekly sales.",
                                        "example": 1
                                      },
                                      "reviews": {
                                        "type": "integer",
                                        "description": "Review count.",
                                        "example": 1
                                      },
                                      "reviewsWeekly": {
                                        "type": "integer",
                                        "description": "Weekly new review count.",
                                        "example": null
                                      },
                                      "favorites": {
                                        "type": "integer",
                                        "description": "Favorite count.",
                                        "example": 1
                                      },
                                      "favoritesWeekly": {
                                        "type": "integer",
                                        "description": "Weekly new favorite count.",
                                        "example": null
                                      },
                                      "rating": {
                                        "type": "number",
                                        "description": "Store rating.",
                                        "example": 4.8
                                      },
                                      "isRaving": {
                                        "type": "integer",
                                        "description": "Raving store indicator: 1 means yes.",
                                        "example": null
                                      },
                                      "isStar": {
                                        "type": "integer",
                                        "description": "Star store indicator: 1 means yes.",
                                        "example": null
                                      },
                                      "status": {
                                        "type": "integer",
                                        "description": "Store status.",
                                        "example": 1
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Tool type: ehunt.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Source type: etsy.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Render style.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "columns": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Provider rendering columns.",
                                  "example": []
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Provider-reported token cost.",
                                  "example": 3600
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "storeNum": 1,
                    "stores": [
                      {
                        "storeId": "123456",
                        "storeName": "Lewshop1",
                        "storeUrl": "https://www.etsy.com/shop/Lewshop1",
                        "country": [],
                        "category": [],
                        "salesTotal": 1,
                        "salesWeekly": 1,
                        "reviews": 1,
                        "favorites": 1,
                        "rating": 4.8,
                        "status": 1
                      }
                    ],
                    "columns": [],
                    "costToken": 3600
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "etsy-store-query",
        "x-nexscope-mcp-tool-name": "nexscope_etsy_store_query",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/fine-cutout-image-segmentation/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Fine Cutout Image Segmentation API",
        "description": "Run the Nexscope interactive cutout create/info flow as one Skill API call. The point list marks foreground/background guidance points.",
        "operationId": "runFineCutoutImageSegmentation",
        "externalDocs": {
          "description": "Fine Cutout Image Segmentation API documentation",
          "url": "https://www.nexscope.ai/api-docs/fine-cutout-image-segmentation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Run the Nexscope interactive cutout create/info flow as one Skill API call. The point list marks foreground/background guidance points.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the image to cut out.",
                    "example": "https://example.com/product.jpg"
                  },
                  "pointList": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "x": {
                          "type": "integer"
                        },
                        "y": {
                          "type": "integer"
                        },
                        "isSelect": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": true
                    },
                    "description": "Selection points. Each item should include x, y, and isSelect.",
                    "example": [
                      {
                        "x": 120,
                        "y": 180,
                        "isSelect": true
                      }
                    ]
                  },
                  "scoreUrl": {
                    "type": "string",
                    "description": "Optional score map URL returned by a previous step.",
                    "example": "https://example.com/score.png"
                  },
                  "featureUrl": {
                    "type": "string",
                    "description": "Optional feature map URL returned by a previous step.",
                    "example": "https://example.com/feature.bin"
                  }
                },
                "required": [
                  "imageUrl",
                  "pointList"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "pointList": [
                    {
                      "x": 120,
                      "y": 180,
                      "isSelect": true
                    }
                  ],
                  "scoreUrl": "https://example.com/score.png",
                  "featureUrl": "https://example.com/feature.bin"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "pointList": [
                  {
                    "x": 120,
                    "y": 180,
                    "isSelect": true
                  }
                ],
                "scoreUrl": "https://example.com/score.png",
                "featureUrl": "https://example.com/feature.bin"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "fine-cutout-image-segmentation",
        "x-nexscope-mcp-tool-name": "nexscope_fine_cutout_image_segmentation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/image-upscale/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Image Upscale API",
        "description": "Increase image resolution and optionally enhance visual quality.",
        "operationId": "runImageUpscale",
        "externalDocs": {
          "description": "Image Upscale API documentation",
          "url": "https://www.nexscope.ai/api-docs/image-upscale"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Increase image resolution and optionally enhance visual quality.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the image to upscale. Width and height must each be at most 4096 pixels.",
                    "example": "https://example.com/product.jpg"
                  },
                  "magnification": {
                    "type": "number",
                    "description": "Upscaling magnification factor from 1 to 4. Decimal values are supported.",
                    "example": 2
                  },
                  "enhanceQuality": {
                    "type": "boolean",
                    "description": "Whether to enhance image quality during upscaling.",
                    "example": true
                  }
                },
                "required": [
                  "imageUrl",
                  "magnification"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "magnification": 2,
                  "enhanceQuality": true
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "magnification": 2,
                "enhanceQuality": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "image-upscale",
        "x-nexscope-mcp-tool-name": "nexscope_image_upscale",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/smart-image-outpainting/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Smart Image Outpainting API",
        "description": "Generate an expanded image around the original content using target width, height, and optional prompt.",
        "operationId": "runSmartImageOutpainting",
        "externalDocs": {
          "description": "Smart Image Outpainting API documentation",
          "url": "https://www.nexscope.ai/api-docs/smart-image-outpainting"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate an expanded image around the original content using target width, height, and optional prompt.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the image to expand. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.",
                    "example": "https://example.com/product.jpg"
                  },
                  "width": {
                    "type": "integer",
                    "description": "Target output width in pixels.",
                    "example": 1200
                  },
                  "height": {
                    "type": "integer",
                    "description": "Target output height in pixels.",
                    "example": 900
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Optional prompt describing the extended scene.",
                    "example": "extend the clean studio background"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl",
                  "width",
                  "height"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "width": 1200,
                  "height": 900,
                  "prompt": "extend the clean studio background",
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "width": 1200,
                "height": 900,
                "prompt": "extend the clean studio background",
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "smart-image-outpainting",
        "x-nexscope-mcp-tool-name": "nexscope_smart_image_outpainting",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/image-translation/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Image Translation API",
        "description": "Translate image text from a source language to a target language for ecommerce localization.",
        "operationId": "runImageTranslation",
        "externalDocs": {
          "description": "Image Translation API documentation",
          "url": "https://www.nexscope.ai/api-docs/image-translation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Translate image text from a source language to a target language for ecommerce localization.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of a JPG, JPEG, PNG, or WEBP image up to 4 MB and between 385 and 3000 pixels.",
                    "example": "https://example.com/product.jpg"
                  },
                  "translationPlatform": {
                    "type": "string",
                    "description": "Translation platform. Supported values: deepl (DeepL), chatgpt (ChatGPT).",
                    "example": "deepl"
                  },
                  "sourceLanguage": {
                    "type": "string",
                    "description": "Source language code. Supported values: CHS (Simplified Chinese), ENG (English), CHT (Traditional Chinese), ESP (Spanish), JPN (Japanese), KOR (Korean), PT (Portuguese), ROM (Romanian), RUS (Russian), VIN (Vietnamese), DEU (German).",
                    "example": "CHS"
                  },
                  "targetLanguage": {
                    "type": "string",
                    "description": "Target language code. Supported values: AR, BG, BN, CHS, CHT, CKB, CSY, DA, DEU, EL, ENG, ESP, ET, FA, FI, FIL, FRA, GU, HE, HI, HR, HUN, ID, ITA, JPN, JW, KOR, LO, LT, LV, MR, MS, MY, NLD, NO, PLK, PT, PTB, ROM, RUS, SK, SL, SV, SW, TA, TE, TG, TH, TL, TRK, UK, UR, VIN.",
                    "example": "ENG"
                  }
                },
                "required": [
                  "imageUrl",
                  "translationPlatform",
                  "sourceLanguage",
                  "targetLanguage"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "translationPlatform": "deepl",
                  "sourceLanguage": "CHS",
                  "targetLanguage": "ENG"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "translationPlatform": "deepl",
                "sourceLanguage": "CHS",
                "targetLanguage": "ENG"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "image-translation",
        "x-nexscope-mcp-tool-name": "nexscope_image_translation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-hand-repair/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Hand Repair API",
        "description": "Improve hand appearance in generated model or lifestyle images.",
        "operationId": "runAiHandRepair",
        "externalDocs": {
          "description": "AI Hand Repair API documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-hand-repair"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Improve hand appearance in generated model or lifestyle images.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the image requiring hand repair. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "personType": {
                    "type": "integer",
                    "description": "Person type. Supported values: 0 (girl), 1 (boy), 2 (adult woman), 3 (adult man).",
                    "example": 2
                  },
                  "maskUrl": {
                    "type": "string",
                    "description": "Optional mask URL for the hand repair area.",
                    "example": "https://example.com/mask.png"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl",
                  "personType"
                ],
                "example": {
                  "imageUrl": "https://example.com/model-reference.jpg",
                  "personType": 2,
                  "maskUrl": "https://example.com/mask.png",
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/model-reference.jpg",
                "personType": 2,
                "maskUrl": "https://example.com/mask.png",
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-hand-repair",
        "x-nexscope-mcp-tool-name": "nexscope_ai_hand_repair",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/image-inpainting/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Image Inpainting API",
        "description": "Repair or regenerate a local image region using a mask and prompt.",
        "operationId": "runImageInpainting",
        "externalDocs": {
          "description": "Image Inpainting API documentation",
          "url": "https://www.nexscope.ai/api-docs/image-inpainting"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Repair or regenerate a local image region using a mask and prompt.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the base image. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.",
                    "example": "https://example.com/product.jpg"
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Prompt describing how to redraw the masked area.",
                    "example": "remove scratches and keep the product realistic"
                  },
                  "maskUrl": {
                    "type": "string",
                    "description": "Public URL of the mask image.",
                    "example": "https://example.com/mask.png"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl",
                  "prompt",
                  "maskUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "prompt": "remove scratches and keep the product realistic",
                  "maskUrl": "https://example.com/mask.png",
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "prompt": "remove scratches and keep the product realistic",
                "maskUrl": "https://example.com/mask.png",
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "image-inpainting",
        "x-nexscope-mcp-tool-name": "nexscope_image_inpainting",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/print-pattern-extraction/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Print & Pattern Extraction API",
        "description": "Extract visible print or pattern elements from product imagery.",
        "operationId": "runPrintPatternExtraction",
        "externalDocs": {
          "description": "Print & Pattern Extraction API documentation",
          "url": "https://www.nexscope.ai/api-docs/print-pattern-extraction"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Extract visible print or pattern elements from product imagery.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the image containing the print. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.",
                    "example": "https://example.com/product.jpg"
                  }
                },
                "required": [
                  "imageUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "print-pattern-extraction",
        "x-nexscope-mcp-tool-name": "nexscope_print_pattern_extraction",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/maidalv-product-tro-detection/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Product TRO Detection",
        "description": "Analyzes a main product image with optional evidence images, text, keywords, and language.",
        "operationId": "runMaidalvProductTroDetection",
        "externalDocs": {
          "description": "Product TRO Detection documentation",
          "url": "https://www.nexscope.ai/api-docs/maidalv-product-tro-detection"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "mainProductImage is required. API callers must provide HTTPS URLs; local file paths are not accepted by Run.",
                "properties": {
                  "mainProductImage": {
                    "type": "string",
                    "description": "Public HTTPS URL of the main product image.",
                    "example": "https://example.com/product.jpg"
                  },
                  "referenceImages": {
                    "type": "array",
                    "items": {},
                    "description": "Public reference image URLs.",
                    "example": []
                  },
                  "otherProductImages": {
                    "type": "array",
                    "items": {},
                    "description": "Additional product image URLs.",
                    "example": []
                  },
                  "ipImages": {
                    "type": "array",
                    "items": {},
                    "description": "Known intellectual-property evidence image URLs.",
                    "example": []
                  },
                  "referenceText": {
                    "type": "string",
                    "description": "Reference text associated with the product.",
                    "example": "Wireless speaker"
                  },
                  "description": {
                    "type": "string",
                    "description": "Product description used as additional evidence.",
                    "example": "Portable wireless speaker"
                  },
                  "ipKeywords": {
                    "type": "array",
                    "items": {},
                    "description": "Intellectual-property keywords.",
                    "example": [
                      "speaker"
                    ]
                  },
                  "language": {
                    "type": "string",
                    "description": "Requested response language.",
                    "example": "en"
                  }
                },
                "required": [
                  "mainProductImage"
                ],
                "example": {
                  "language": "en",
                  "mainProductImage": "https://example.com/product.jpg"
                },
                "additionalProperties": true
              },
              "example": {
                "language": "en",
                "mainProductImage": "https://example.com/product.jpg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "checkId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider check identifier.",
                                  "example": "check-id"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Detection status.",
                                  "example": "success"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Number of high-risk findings in results[].",
                                  "example": 2
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider render style.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "results": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "High-risk potential infringement findings.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "riskLevel": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "description": "Risk grade when scored.",
                                            "example": null
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "columns": {
                                        "anyOf": [
                                          {
                                            "type": "array",
                                            "description": "Provider render columns, which may differ in length from finding lists.",
                                            "example": null
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ]
                                      },
                                      "ipType": {
                                        "type": "string",
                                        "description": "IP type: Trademark, Copyright, or Patent.",
                                        "example": null
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "IP text, such as a trademark or patent title.",
                                        "example": null
                                      },
                                      "ipOwner": {
                                        "type": "string",
                                        "description": "IP owner.",
                                        "example": null
                                      },
                                      "regNo": {
                                        "type": "string",
                                        "description": "Registration number, possibly a JSON-encoded array.",
                                        "example": null
                                      },
                                      "riskScore": {
                                        "type": "number",
                                        "description": "Risk score from 0 to 10 when scored.",
                                        "example": null
                                      },
                                      "riskDescription": {
                                        "type": "string",
                                        "description": "Risk explanation when scored.",
                                        "example": null
                                      },
                                      "ipAssetUrls": {
                                        "type": "array",
                                        "description": "IP evidence image URLs.",
                                        "example": null
                                      },
                                      "plaintiffId": {
                                        "type": "integer",
                                        "description": "TRO plaintiff ID when available.",
                                        "example": null
                                      },
                                      "plaintiffName": {
                                        "type": "string",
                                        "description": "TRO plaintiff name when available.",
                                        "example": null
                                      },
                                      "numberOfCases": {
                                        "type": "integer",
                                        "description": "Plaintiff case count when available.",
                                        "example": null
                                      },
                                      "lastCaseDocket": {
                                        "type": "string",
                                        "description": "Latest case docket when available.",
                                        "example": null
                                      },
                                      "lastCaseDateFiled": {
                                        "type": "string",
                                        "description": "Latest case filing date when available.",
                                        "example": null
                                      },
                                      "report": {
                                        "type": "string",
                                        "description": "AI legal assessment report in the requested language.",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "nonResults": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "description": "Other IP findings, including possible TRO plaintiff details.",
                                  "example": [],
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "ipType": {
                                        "type": "string",
                                        "description": "IP type: Trademark, Copyright, or Patent.",
                                        "example": null
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "IP text, such as a trademark or patent title.",
                                        "example": null
                                      },
                                      "ipOwner": {
                                        "type": "string",
                                        "description": "IP owner.",
                                        "example": null
                                      },
                                      "regNo": {
                                        "type": "string",
                                        "description": "Registration number, possibly a JSON-encoded array.",
                                        "example": null
                                      },
                                      "riskLevel": {
                                        "type": "string",
                                        "description": "Risk grade when scored.",
                                        "example": null
                                      },
                                      "riskScore": {
                                        "type": "number",
                                        "description": "Risk score from 0 to 10 when scored.",
                                        "example": null
                                      },
                                      "riskDescription": {
                                        "type": "string",
                                        "description": "Risk explanation when scored.",
                                        "example": null
                                      },
                                      "ipAssetUrls": {
                                        "type": "array",
                                        "description": "IP evidence image URLs.",
                                        "example": null
                                      },
                                      "plaintiffId": {
                                        "type": "integer",
                                        "description": "TRO plaintiff ID when available.",
                                        "example": null
                                      },
                                      "plaintiffName": {
                                        "type": "string",
                                        "description": "TRO plaintiff name when available.",
                                        "example": null
                                      },
                                      "numberOfCases": {
                                        "type": "integer",
                                        "description": "Plaintiff case count when available.",
                                        "example": null
                                      },
                                      "lastCaseDocket": {
                                        "type": "string",
                                        "description": "Latest case docket when available.",
                                        "example": null
                                      },
                                      "lastCaseDateFiled": {
                                        "type": "string",
                                        "description": "Latest case filing date when available.",
                                        "example": null
                                      },
                                      "report": {
                                        "type": "string",
                                        "description": "AI legal assessment report in the requested language.",
                                        "example": null
                                      }
                                    }
                                  }
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Provider-reported token cost.",
                                  "example": 225000
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Execution time reported by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "checkId": "check-id",
                    "status": "success",
                    "total": 2,
                    "results": [],
                    "nonResults": [],
                    "costToken": 225000
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "maidalv-product-tro-detection",
        "x-nexscope-mcp-tool-name": "nexscope_maidalv_product_tro_detection",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/mercado-product-selection/run": {
      "post": {
        "tags": [
          "Product & Market Research"
        ],
        "summary": "Mercado Product Selection",
        "description": "Validates the selected tool and its required arguments before calling the governed Lingdong gateway.",
        "operationId": "runMercadoProductSelection",
        "externalDocs": {
          "description": "Mercado Product Selection documentation",
          "url": "https://www.nexscope.ai/api-docs/mercado-product-selection"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "toolName must be one of the 24 documented values. Required argument fields depend on toolName.",
                "properties": {
                  "toolName": {
                    "type": "string",
                    "description": "Exact Mercado tool name.",
                    "example": "categorySearch"
                  },
                  "arguments": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Arguments for the selected tool.",
                    "example": {
                      "searchText": "Auriculares",
                      "siteId": "MLM"
                    }
                  }
                },
                "required": [
                  "toolName",
                  "arguments"
                ],
                "example": {
                  "arguments": {
                    "searchText": "Auriculares",
                    "siteId": "MLM"
                  },
                  "toolName": "categorySearch"
                },
                "additionalProperties": true
              },
              "example": {
                "arguments": {
                  "searchText": "Auriculares",
                  "siteId": "MLM"
                },
                "toolName": "categorySearch"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider result type.",
                                  "example": "rawMcpToolResult"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "toolName": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Executed Mercado tool name.",
                                  "example": "categorySearch"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "charged": {
                              "anyOf": [
                                {
                                  "type": "boolean",
                                  "description": "Whether the selected tool is paid.",
                                  "example": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "data": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "description": "Parsed business data, or provider text when the result is not JSON.",
                                  "example": {}
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "contentText": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Original concatenated provider text.",
                                  "example": "Category results..."
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "textParsedAsJson": {
                              "anyOf": [
                                {
                                  "type": "boolean",
                                  "description": "Whether provider text was parsed as JSON.",
                                  "example": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Inferred result count when available.",
                                  "example": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costToken": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Provider-reported token cost; free tools return zero.",
                                  "example": 0
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "costTime": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Gateway execution time in milliseconds.",
                                  "example": 308
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "title": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific response title.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceType": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source platform type.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "sourceTool": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Provider-specific source tool name.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "page": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageSize": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Page size returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pageItemCount": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Item count on the current page returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "totalPage": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "description": "Total page count returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "dataSnapshotMonth": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "description": "Data snapshot month returned by the upstream provider.",
                                  "example": null
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [],
                          "additionalProperties": true
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "type": "rawMcpToolResult",
                    "toolName": "categorySearch",
                    "charged": false,
                    "data": {},
                    "contentText": "Category results...",
                    "textParsedAsJson": true,
                    "total": 1,
                    "costToken": 0,
                    "costTime": 308
                  },
                  "code": 0,
                  "msg": "ok",
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "mercado-product-selection",
        "x-nexscope-mcp-tool-name": "nexscope_mercado_product_selection",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/object-eraser-image-object-removal/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Object Eraser & Image Object Removal API",
        "description": "Remove selected objects or regions using a mask image.",
        "operationId": "runObjectEraserImageObjectRemoval",
        "externalDocs": {
          "description": "Object Eraser & Image Object Removal API documentation",
          "url": "https://www.nexscope.ai/api-docs/object-eraser-image-object-removal"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Remove selected objects or regions using a mask image.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the base image. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.",
                    "example": "https://example.com/product.jpg"
                  },
                  "maskImageUrl": {
                    "type": "string",
                    "description": "Public URL of the mask image for the area to erase.",
                    "example": "https://example.com/mask.png"
                  }
                },
                "required": [
                  "imageUrl",
                  "maskImageUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "maskImageUrl": "https://example.com/mask.png"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "maskImageUrl": "https://example.com/mask.png"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "object-eraser-image-object-removal",
        "x-nexscope-mcp-tool-name": "nexscope_object_eraser_image_object_removal",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/jewelry-text-design/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Jewelry Text Design API",
        "description": "Create decorative linked-word imagery using font, size, and prompt controls.",
        "operationId": "runJewelryTextDesign",
        "externalDocs": {
          "description": "Jewelry Text Design API documentation",
          "url": "https://www.nexscope.ai/api-docs/jewelry-text-design"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Create decorative linked-word imagery using font, size, and prompt controls.",
                "properties": {
                  "fontname": {
                    "type": "string",
                    "description": "Font name. Allowed values: Caitlyn, ItaliannoRob, Alison, ALSScript, WhiteAngelica, Milkshake, ScriptMTBold, PassionsConflictROB, Sacramento, Cervanttis, Notera 2 PERSONAL USE ONLY, UyghurMerdane, OldEnglishText, Halimun, AlexBrush, Scriptina, CounselorScript, EliannaBoldItalic, AutumnChant, MagnoliaScript.",
                    "example": "UyghurMerdane"
                  },
                  "fontSize": {
                    "type": "integer",
                    "description": "Output font size.",
                    "example": 10
                  },
                  "left": {
                    "type": "boolean",
                    "description": "Whether to add a ring on the left side. Defaults to false.",
                    "example": false
                  },
                  "right": {
                    "type": "boolean",
                    "description": "Whether to add a ring on the right side. Defaults to false.",
                    "example": false
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Jewelry text content.",
                    "example": "hello"
                  }
                },
                "required": [
                  "fontname",
                  "fontSize",
                  "prompt"
                ],
                "example": {
                  "fontname": "UyghurMerdane",
                  "fontSize": 10,
                  "left": false,
                  "right": false,
                  "prompt": "hello"
                },
                "additionalProperties": true
              },
              "example": {
                "fontname": "UyghurMerdane",
                "fontSize": 10,
                "left": false,
                "right": false,
                "prompt": "hello"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "jewelry-text-design",
        "x-nexscope-mcp-tool-name": "nexscope_jewelry_text_design",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/handheld-product-mockup/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Handheld Product Mockup API",
        "description": "Generate natural hand-held product imagery from a person image and target product asset.",
        "operationId": "runHandheldProductMockup",
        "externalDocs": {
          "description": "Handheld Product Mockup API documentation",
          "url": "https://www.nexscope.ai/api-docs/handheld-product-mockup"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate natural hand-held product imagery from a person image and target product asset.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the product image. The image must be at most 20 MB and between 385 and 8192 pixels in both width and height.",
                    "example": "https://example.com/product.jpg"
                  },
                  "targetOriginUrl": {
                    "type": "string",
                    "description": "Public URL of the person or hand pose image.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "targetMaskUrl": {
                    "type": "string",
                    "description": "Public URL of the black-and-white hand-held area mask. Required because this API accepts custom pose images rather than saved upstream materials.",
                    "example": "https://example.com/mask.png"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl",
                  "targetOriginUrl",
                  "targetMaskUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "targetOriginUrl": "https://example.com/model-reference.jpg",
                  "targetMaskUrl": "https://example.com/mask.png",
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "targetOriginUrl": "https://example.com/model-reference.jpg",
                "targetMaskUrl": "https://example.com/mask.png",
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "handheld-product-mockup",
        "x-nexscope-mcp-tool-name": "nexscope_handheld_product_mockup",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/image-captioning/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Image Captioning API",
        "description": "Extract descriptive prompts or selling-point text from one or more images.",
        "operationId": "runImageCaptioning",
        "externalDocs": {
          "description": "Image Captioning API documentation",
          "url": "https://www.nexscope.ai/api-docs/image-captioning"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Extract descriptive prompts or selling-point text from one or more images.",
                "properties": {
                  "type": {
                    "type": "integer",
                    "description": "Analysis type. Supported values: 5 (similar-image prompt), 13 (scene prompt), 30 (image-to-video analysis), 69 (apparel selling points), 71 (product selling points), 73 (sales-video script), 89 (video-reclone prompt).",
                    "example": 71
                  },
                  "imageUrlList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public image URLs used for analysis. Provide no more than 6 images for modes that accept multiple images.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 6
                  },
                  "keyword": {
                    "type": "string",
                    "description": "Optional keyword context.",
                    "example": "phone case"
                  },
                  "provider": {
                    "type": "string",
                    "description": "Analysis provider. Supported values: API_PRE_POINT (default), API_LAYOUT_DESC.",
                    "example": "API_PRE_POINT"
                  },
                  "refVideoUrl": {
                    "type": "string",
                    "description": "Reference video URL. Required when type is 89.",
                    "example": "https://example.com/reference-video.mp4"
                  },
                  "saleCountry": {
                    "type": "string",
                    "description": "Target sale country code.",
                    "example": "US"
                  },
                  "targetLanguage": {
                    "type": "string",
                    "description": "Target language for generated text. Used by video-reclone analysis.",
                    "example": "English"
                  },
                  "duration": {
                    "type": "integer",
                    "description": "Target duration in seconds. Used by video-reclone analysis.",
                    "example": 15
                  }
                },
                "required": [
                  "type",
                  "imageUrlList"
                ],
                "example": {
                  "type": 71,
                  "imageUrlList": [
                    "https://example.com/product.jpg"
                  ],
                  "keyword": "phone case",
                  "provider": "API_PRE_POINT"
                },
                "additionalProperties": true
              },
              "example": {
                "type": 71,
                "imageUrlList": [
                  "https://example.com/product.jpg"
                ],
                "keyword": "phone case",
                "provider": "API_PRE_POINT"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "image-captioning",
        "x-nexscope-mcp-tool-name": "nexscope_image_captioning",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/product-image-enhancement/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Product Image Enhancement API",
        "description": "Improve product presentation quality in a single ecommerce image.",
        "operationId": "runProductImageEnhancement",
        "externalDocs": {
          "description": "Product Image Enhancement API documentation",
          "url": "https://www.nexscope.ai/api-docs/product-image-enhancement"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Improve product presentation quality in a single ecommerce image.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the product image to retouch. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.",
                    "example": "https://example.com/product.jpg"
                  }
                },
                "required": [
                  "imageUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "product-image-enhancement",
        "x-nexscope-mcp-tool-name": "nexscope_product_image_enhancement",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/image-text-editing/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Image Text Editing API",
        "description": "Use an image mask to remove or edit text regions in an ecommerce image.",
        "operationId": "runImageTextEditing",
        "externalDocs": {
          "description": "Image Text Editing API documentation",
          "url": "https://www.nexscope.ai/api-docs/image-text-editing"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Use an image mask to remove or edit text regions in an ecommerce image.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the base image.",
                    "example": "https://example.com/product.jpg"
                  },
                  "imageMaskUrl": {
                    "type": "string",
                    "description": "Public URL of the text mask image.",
                    "example": "https://example.com/mask.png"
                  }
                },
                "required": [
                  "imageUrl",
                  "imageMaskUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "imageMaskUrl": "https://example.com/mask.png"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "imageMaskUrl": "https://example.com/mask.png"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "image-text-editing",
        "x-nexscope-mcp-tool-name": "nexscope_image_text_editing",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/smart-image-edit-manipulation-v3/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Smart Image Edit & Manipulation API v3",
        "description": "Perform general image editing with provider, prompt, resolution, aspect ratio, and quality controls.",
        "operationId": "runSmartImageEditManipulationV3",
        "externalDocs": {
          "description": "Smart Image Edit & Manipulation API v3 documentation",
          "url": "https://www.nexscope.ai/api-docs/smart-image-edit-manipulation-v3"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Perform general image editing with provider, prompt, resolution, aspect ratio, and quality controls.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the image to edit. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.",
                    "example": "https://example.com/product.jpg"
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Editing instruction.",
                    "example": "make the background pure white and keep the product unchanged"
                  },
                  "provider": {
                    "type": "string",
                    "description": "Image model. Supported values: BANANA, BANANA_2, BANANA_PRO, WAN2_7, QWEN_IMAGE_3_PRO, SEEDREAM5, GPT_2_IMAGE, or AIDRAW_EDIT.",
                    "example": "BANANA_PRO"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4.",
                    "example": 1
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Target resolution preset.",
                    "example": "1K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target aspect ratio.",
                    "example": "1:1"
                  },
                  "supplyType": {
                    "type": "string",
                    "description": "Generation route. Supported values: eco or stable. Defaults to stable.",
                    "example": "stable"
                  },
                  "needOptimize": {
                    "type": "boolean",
                    "description": "Whether the prompt should be optimized upstream.",
                    "example": true
                  },
                  "template": {
                    "type": "string",
                    "description": "Optional Nexscope editing template. Supported values: white-background, product-main-image-retouching, scene-generation, poster-design, add-person-or-object, change-animal, flat-lay-apparel, 3d-apparel, mannequin-to-model, cartoon-illustration, body-reshape, change-style, remove-element, remove-text, remove-watermark, add-watermark.",
                    "example": "white-background"
                  },
                  "source": {
                    "type": "string",
                    "description": "Optional traffic or product source code.",
                    "example": "api"
                  },
                  "quality": {
                    "type": "string",
                    "description": "GPT Image quality only. Supported values: low, medium, or high. Defaults to medium.",
                    "example": "medium"
                  }
                },
                "required": [
                  "imageUrl",
                  "prompt",
                  "provider"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "prompt": "make the background pure white and keep the product unchanged",
                  "provider": "BANANA_PRO",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1",
                  "supplyType": "stable",
                  "needOptimize": true,
                  "template": "white-background",
                  "source": "api",
                  "quality": "medium"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "prompt": "make the background pure white and keep the product unchanged",
                "provider": "BANANA_PRO",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1",
                "supplyType": "stable",
                "needOptimize": true,
                "template": "white-background",
                "source": "api",
                "quality": "medium"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "smart-image-edit-manipulation-v3",
        "x-nexscope-mcp-tool-name": "nexscope_smart_image_edit_manipulation_v3",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/whitebg-image/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "White Background Product Image API",
        "description": "Generate one square white-background product image from one or two references of the same product using GPT Image 2. Submit one approved target per request. Review product identity and listing suitability before use; this endpoint does not perform reference inspection, image-set planning, or marketplace compliance certification. Generation consumes Nexscope credits.",
        "operationId": "runWhitebgImage",
        "externalDocs": {
          "description": "White Background Product Image API documentation",
          "url": "https://www.nexscope.ai/api-docs/whitebg-image"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate one square white-background product image from one or two references of the same product using GPT Image 2. Submit one approved target per request. Review product identity and listing suitability before use; this endpoint does not perform reference inspection, image-set planning, or marketplace compliance certification. Generation consumes Nexscope credits.",
                "properties": {
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs of the same product. Provide up to 2 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 2
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Describe one target supported by the references, up to 350 characters. Output is fixed to one 1:1 image.",
                    "example": "Show the complete product from the supplied front view.",
                    "maxLength": 350
                  }
                },
                "required": [
                  "imageList",
                  "prompt"
                ],
                "example": {
                  "imageList": [
                    "https://example.com/product.jpg"
                  ],
                  "prompt": "Show the complete product from the supplied front view."
                },
                "additionalProperties": true
              },
              "example": {
                "imageList": [
                  "https://example.com/product.jpg"
                ],
                "prompt": "Show the complete product from the supplied front view."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "whitebg-image",
        "x-nexscope-mcp-tool-name": "nexscope_whitebg_image",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/smart-multi-image-editing-v3/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Smart Multi-Image Editing API v3",
        "description": "Create an edited output from multiple source images using prompt, provider, resolution, and quality controls.",
        "operationId": "runSmartMultiImageEditingV3",
        "externalDocs": {
          "description": "Smart Multi-Image Editing API v3 documentation",
          "url": "https://www.nexscope.ai/api-docs/smart-multi-image-editing-v3"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Create an edited output from multiple source images using prompt, provider, resolution, and quality controls.",
                "properties": {
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public image URLs to combine or reference. Provide no more than 6 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/model-reference.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 6
                  },
                  "provider": {
                    "type": "string",
                    "description": "Image model. Supported values: BANANA, BANANA_2, BANANA_PRO, WAN2_7, QWEN_IMAGE_3_PRO, SEEDREAM5, GPT_2_IMAGE, or AIDRAW_EDIT.",
                    "example": "BANANA_PRO"
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Optional fusion instruction, up to 600 characters.",
                    "example": "combine the product with the model in a clean studio scene"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Defaults to 1.",
                    "example": 1
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Target resolution preset.",
                    "example": "1K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target aspect ratio.",
                    "example": "1:1"
                  },
                  "supplyType": {
                    "type": "string",
                    "description": "Generation route. Supported values: eco or stable. Defaults to stable.",
                    "example": "stable"
                  },
                  "needOptimize": {
                    "type": "boolean",
                    "description": "Whether the prompt should be optimized upstream.",
                    "example": true
                  },
                  "template": {
                    "type": "string",
                    "description": "Optional fusion template. Supported values: outfit-fusion, outfit-try-on.",
                    "example": "outfit-fusion"
                  },
                  "quality": {
                    "type": "string",
                    "description": "GPT Image quality only. Supported values: low, medium, or high. Defaults to medium.",
                    "example": "medium"
                  }
                },
                "required": [
                  "imageList",
                  "provider"
                ],
                "example": {
                  "imageList": [
                    "https://example.com/product.jpg",
                    "https://example.com/model-reference.jpg"
                  ],
                  "provider": "BANANA_PRO",
                  "prompt": "combine the product with the model in a clean studio scene",
                  "outputNum": 1,
                  "resolution": "1K",
                  "aspectRatio": "1:1",
                  "supplyType": "stable",
                  "needOptimize": true,
                  "template": "outfit-fusion",
                  "quality": "medium"
                },
                "additionalProperties": true
              },
              "example": {
                "imageList": [
                  "https://example.com/product.jpg",
                  "https://example.com/model-reference.jpg"
                ],
                "provider": "BANANA_PRO",
                "prompt": "combine the product with the model in a clean studio scene",
                "outputNum": 1,
                "resolution": "1K",
                "aspectRatio": "1:1",
                "supplyType": "stable",
                "needOptimize": true,
                "template": "outfit-fusion",
                "quality": "medium"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "smart-multi-image-editing-v3",
        "x-nexscope-mcp-tool-name": "nexscope_smart_multi_image_editing_v3",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-video-reclone/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Video Reclone API",
        "description": "Generate a product marketing video using a reference video, reference images, and model-specific generation settings.",
        "operationId": "runAiVideoReclone",
        "externalDocs": {
          "description": "AI Video Reclone API documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-video-reclone"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a product marketing video using a reference video, reference images, and model-specific generation settings.",
                "properties": {
                  "refVideoUrl": {
                    "type": "string",
                    "description": "Public URL of the reference video.",
                    "example": "https://example.com/reference-video.mp4"
                  },
                  "refImageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public image URLs for product or visual references.",
                    "example": [
                      "https://example.com/product.jpg"
                    ]
                  },
                  "videoType": {
                    "type": "string",
                    "description": "Video model. Supported values: seedance-2-0, seedance-2-0-fast, seedance-2-0-mini, seedance-2-5, or happyhorse-v2.",
                    "example": "seedance-2-0-fast"
                  },
                  "videoTime": {
                    "type": "integer",
                    "description": "Optional target video duration in seconds. Seedance 2.0, Fast, Mini, and HappyHorse V2 support any integer from 5 through 15; Seedance 2.5 supports 5, 10, 15, 20, 25, or 30.",
                    "example": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Target video resolution supported by the selected model, such as 720p or 1080p.",
                    "example": "720p"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by the selected model.",
                    "example": "9:16"
                  },
                  "saleCountry": {
                    "type": "string",
                    "description": "Target market country code used to localize the recreated video.",
                    "example": "US"
                  },
                  "targetLanguage": {
                    "type": "string",
                    "description": "Target spoken and on-screen language for the recreated video.",
                    "example": "English"
                  },
                  "productInfo": {
                    "type": "string",
                    "description": "Concise product information used to guide the recreation. Maximum 2500 characters.",
                    "example": "Slim shockproof phone case with a clear finish."
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Optional creative direction prompt.",
                    "example": "highlight the slim protective design"
                  }
                },
                "required": [
                  "refVideoUrl",
                  "refImageList",
                  "videoType",
                  "resolution",
                  "saleCountry",
                  "targetLanguage"
                ],
                "example": {
                  "refVideoUrl": "https://example.com/reference-video.mp4",
                  "refImageList": [
                    "https://example.com/product.jpg"
                  ],
                  "videoType": "seedance-2-0-fast",
                  "videoTime": 10,
                  "resolution": "720p",
                  "aspectRatio": "9:16",
                  "saleCountry": "US",
                  "targetLanguage": "English",
                  "productInfo": "Slim shockproof phone case with a clear finish.",
                  "prompt": "highlight the slim protective design"
                },
                "additionalProperties": true
              },
              "example": {
                "refVideoUrl": "https://example.com/reference-video.mp4",
                "refImageList": [
                  "https://example.com/product.jpg"
                ],
                "videoType": "seedance-2-0-fast",
                "videoTime": 10,
                "resolution": "720p",
                "aspectRatio": "9:16",
                "saleCountry": "US",
                "targetLanguage": "English",
                "productInfo": "Slim shockproof phone case with a clear finish.",
                "prompt": "highlight the slim protective design"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-video-reclone",
        "x-nexscope-mcp-tool-name": "nexscope_ai_video_reclone",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-product-marketing-image-set-v4/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Product Marketing Image Set API v4",
        "description": "Create ecommerce product marketing materials such as selling-point images and A+ style visuals from product images and brief inputs.",
        "operationId": "runAiProductMarketingImageSetV4",
        "externalDocs": {
          "description": "AI Product Marketing Image Set API v4 documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-product-marketing-image-set-v4"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Create ecommerce product marketing materials such as selling-point images and A+ style visuals from product images and brief inputs.",
                "properties": {
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public product image URLs. Provide no more than 5 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 5
                  },
                  "provider": {
                    "type": "string",
                    "description": "Image model. Defaults to BANANA_2. Supported values: BANANA_2, BANANA_2_LITE, BANANA_PRO, WAN2_7, SEEDREAM5_PRO, GPT_2_IMAGE.",
                    "example": "BANANA_2"
                  },
                  "sellerPoint": {
                    "type": "string",
                    "description": "Product selling points, up to 2500 characters. Required when isExtractPrePoint is false.",
                    "example": "Shockproof, slim, clear phone case",
                    "maxLength": 2500
                  },
                  "isExtractPrePoint": {
                    "type": "boolean",
                    "description": "Whether to automatically extract selling points. Defaults to false. When false, sellerPoint is required.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Target resolution supported by the selected provider.",
                    "example": "2K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target aspect ratio supported by the selected provider.",
                    "example": "1:1"
                  },
                  "noText": {
                    "type": "boolean",
                    "description": "Whether generated images should avoid text.",
                    "example": false
                  },
                  "brandKey": {
                    "type": "string",
                    "description": "Optional brand information serialized as a JSON string. Supported keys: brandColor, fontStyle, salesRegion, language, platform, customSettings.",
                    "example": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}"
                  },
                  "quality": {
                    "type": "string",
                    "description": "GPT Image quality only. Supported values: low, medium, or high.",
                    "example": "medium"
                  },
                  "sensitiveLibraryId": {
                    "type": "integer",
                    "description": "Optional sensitive-word library ID used to screen generated copy.",
                    "example": 1001
                  },
                  "replaceLibraryId": {
                    "type": "integer",
                    "description": "Optional replacement-word library ID used to rewrite generated copy.",
                    "example": 1002
                  },
                  "aPlusNum": {
                    "type": "integer",
                    "description": "Number of standard A+ images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "aPlusProNum": {
                    "type": "integer",
                    "description": "Number of premium A+ images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "aPlusHasPhone": {
                    "type": "boolean",
                    "description": "Whether A+ output includes phone display layouts.",
                    "example": false
                  },
                  "aPlusAspectRatio": {
                    "type": "string",
                    "description": "Premium A+ aspect ratio. Supported values: 16:9, 9:16, 1:1, 1:3.7.",
                    "example": "1:1"
                  },
                  "sellerTypeNum": {
                    "type": "integer",
                    "description": "Number of selling-point images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "sceneTypeNum": {
                    "type": "integer",
                    "description": "Number of scene images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "closeUpTypeNum": {
                    "type": "integer",
                    "description": "Number of close-up images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "closeUpWhiteTypeNum": {
                    "type": "integer",
                    "description": "Number of white-background close-up images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "whiteBgTypeNum": {
                    "type": "integer",
                    "description": "Number of white-background images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "aPlusStyles": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "prompt": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    },
                    "description": "Optional A+ style entries. Each item may contain a saved style id or a custom prompt.",
                    "example": [
                      {
                        "id": 1
                      },
                      {
                        "prompt": "clean premium layout"
                      }
                    ]
                  },
                  "pointStyles": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "prompt": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    },
                    "description": "Optional selling-point style entries. Each item may contain a saved style id or a custom prompt.",
                    "example": [
                      {
                        "id": 2
                      },
                      {
                        "prompt": "minimal feature callouts"
                      }
                    ]
                  }
                },
                "required": [
                  "imageList"
                ],
                "example": {
                  "imageList": [
                    "https://example.com/product.jpg"
                  ],
                  "provider": "BANANA_2",
                  "sellerPoint": "Shockproof, slim, clear phone case",
                  "isExtractPrePoint": false,
                  "resolution": "2K",
                  "aspectRatio": "1:1",
                  "noText": false,
                  "brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
                  "quality": "medium",
                  "sensitiveLibraryId": 1001,
                  "replaceLibraryId": 1002,
                  "aPlusNum": 0,
                  "aPlusProNum": 0,
                  "aPlusHasPhone": false,
                  "aPlusAspectRatio": "1:1",
                  "sellerTypeNum": 0,
                  "sceneTypeNum": 0,
                  "closeUpTypeNum": 0,
                  "closeUpWhiteTypeNum": 0,
                  "whiteBgTypeNum": 0,
                  "aPlusStyles": [
                    {
                      "id": 1
                    },
                    {
                      "prompt": "clean premium layout"
                    }
                  ],
                  "pointStyles": [
                    {
                      "id": 2
                    },
                    {
                      "prompt": "minimal feature callouts"
                    }
                  ]
                },
                "additionalProperties": true
              },
              "example": {
                "imageList": [
                  "https://example.com/product.jpg"
                ],
                "provider": "BANANA_2",
                "sellerPoint": "Shockproof, slim, clear phone case",
                "isExtractPrePoint": false,
                "resolution": "2K",
                "aspectRatio": "1:1",
                "noText": false,
                "brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
                "quality": "medium",
                "sensitiveLibraryId": 1001,
                "replaceLibraryId": 1002,
                "aPlusNum": 0,
                "aPlusProNum": 0,
                "aPlusHasPhone": false,
                "aPlusAspectRatio": "1:1",
                "sellerTypeNum": 0,
                "sceneTypeNum": 0,
                "closeUpTypeNum": 0,
                "closeUpWhiteTypeNum": 0,
                "whiteBgTypeNum": 0,
                "aPlusStyles": [
                  {
                    "id": 1
                  },
                  {
                    "prompt": "clean premium layout"
                  }
                ],
                "pointStyles": [
                  {
                    "id": 2
                  },
                  {
                    "prompt": "minimal feature callouts"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-product-marketing-image-set-v4",
        "x-nexscope-mcp-tool-name": "nexscope_ai_product_marketing_image_set_v4",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-apparel-image-set-photography-v3/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Apparel Image Set & Photography API v3",
        "description": "Create apparel ecommerce image sets from clothing images with optional model and scene references.",
        "operationId": "runAiApparelImageSetPhotographyV3",
        "externalDocs": {
          "description": "AI Apparel Image Set & Photography API v3 documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-apparel-image-set-photography-v3"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Create apparel ecommerce image sets from clothing images with optional model and scene references.",
                "properties": {
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public apparel image URLs. Provide no more than 5 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 384 and 4096 pixels.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 5
                  },
                  "provider": {
                    "type": "string",
                    "description": "Image model. Defaults to BANANA_2. Supported values: BANANA_2, BANANA_2_LITE, BANANA_PRO, WAN2_7, SEEDREAM5_PRO, GPT_2_IMAGE.",
                    "example": "BANANA_2"
                  },
                  "sellerPoint": {
                    "type": "string",
                    "description": "Product selling points, up to 2500 characters. Required when isExtractPrePoint is false.",
                    "example": "Lightweight breathable summer dress",
                    "maxLength": 2500
                  },
                  "isExtractPrePoint": {
                    "type": "boolean",
                    "description": "Whether to automatically extract selling points. Defaults to false. When false, sellerPoint is required.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Target resolution supported by the selected provider.",
                    "example": "2K"
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target aspect ratio.",
                    "example": "1:1"
                  },
                  "noText": {
                    "type": "boolean",
                    "description": "Whether generated images should avoid text.",
                    "example": false
                  },
                  "brandKey": {
                    "type": "string",
                    "description": "Optional brand information serialized as a JSON string. Supported keys: brandColor, fontStyle, salesRegion, language, platform, customSettings.",
                    "example": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}"
                  },
                  "quality": {
                    "type": "string",
                    "description": "GPT Image quality only. Supported values: low, medium, or high.",
                    "example": "medium"
                  },
                  "sensitiveLibraryId": {
                    "type": "integer",
                    "description": "Optional sensitive-word library ID used to screen generated copy.",
                    "example": 1001
                  },
                  "replaceLibraryId": {
                    "type": "integer",
                    "description": "Optional replacement-word library ID used to rewrite generated copy.",
                    "example": 1002
                  },
                  "modelImageUrl": {
                    "type": "string",
                    "description": "Optional model reference image URL.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "sceneImageUrl": {
                    "type": "string",
                    "description": "Optional scene reference image URL.",
                    "example": "https://example.com/scene.jpg"
                  },
                  "isExactScene": {
                    "type": "boolean",
                    "description": "Whether to match the provided scene closely. Defaults to true.",
                    "example": true
                  },
                  "modelAndSceneInfo": {
                    "type": "string",
                    "description": "Model and scene information serialized as a JSON string or concise structured text.",
                    "example": "{\"model\":\"female adult\",\"scene\":\"studio\"}"
                  },
                  "aPlusNum": {
                    "type": "integer",
                    "description": "Number of standard A+ images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "aPlusProNum": {
                    "type": "integer",
                    "description": "Number of premium A+ images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "aPlusHasPhone": {
                    "type": "boolean",
                    "description": "Whether A+ output includes phone display layouts.",
                    "example": false
                  },
                  "aPlusAspectRatio": {
                    "type": "string",
                    "description": "A+ output aspect ratio. Supported values: 16:9, 9:16, 1:1, 1:3.7.",
                    "example": "1:1"
                  },
                  "modelTypeNum": {
                    "type": "integer",
                    "description": "Number of model images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "insTypeNum": {
                    "type": "integer",
                    "description": "Number of social-style images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "sellerTypeNum": {
                    "type": "integer",
                    "description": "Number of selling-point images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "sizeTypeNum": {
                    "type": "integer",
                    "description": "Number of size-information images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "whiteTypeNum": {
                    "type": "integer",
                    "description": "Number of white-background images, from 0 to 12. Defaults to 0.",
                    "example": 0
                  },
                  "aPlusStyles": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "prompt": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    },
                    "description": "Optional A+ style entries. Each item may contain a saved style id or a custom prompt.",
                    "example": [
                      {
                        "id": 1
                      },
                      {
                        "prompt": "clean editorial layout"
                      }
                    ]
                  },
                  "pointStyles": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "prompt": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    },
                    "description": "Optional selling-point style entries. Each item may contain a saved style id or a custom prompt.",
                    "example": [
                      {
                        "id": 2
                      },
                      {
                        "prompt": "minimal feature callouts"
                      }
                    ]
                  }
                },
                "required": [
                  "imageList"
                ],
                "example": {
                  "imageList": [
                    "https://example.com/product.jpg"
                  ],
                  "provider": "BANANA_2",
                  "sellerPoint": "Lightweight breathable summer dress",
                  "isExtractPrePoint": false,
                  "resolution": "2K",
                  "aspectRatio": "1:1",
                  "noText": false,
                  "brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
                  "quality": "medium",
                  "sensitiveLibraryId": 1001,
                  "replaceLibraryId": 1002,
                  "modelImageUrl": "https://example.com/model-reference.jpg",
                  "sceneImageUrl": "https://example.com/scene.jpg",
                  "isExactScene": true,
                  "modelAndSceneInfo": "{\"model\":\"female adult\",\"scene\":\"studio\"}",
                  "aPlusNum": 0,
                  "aPlusProNum": 0,
                  "aPlusHasPhone": false,
                  "aPlusAspectRatio": "1:1",
                  "modelTypeNum": 0,
                  "insTypeNum": 0,
                  "sellerTypeNum": 0,
                  "sizeTypeNum": 0,
                  "whiteTypeNum": 0,
                  "aPlusStyles": [
                    {
                      "id": 1
                    },
                    {
                      "prompt": "clean editorial layout"
                    }
                  ],
                  "pointStyles": [
                    {
                      "id": 2
                    },
                    {
                      "prompt": "minimal feature callouts"
                    }
                  ]
                },
                "additionalProperties": true
              },
              "example": {
                "imageList": [
                  "https://example.com/product.jpg"
                ],
                "provider": "BANANA_2",
                "sellerPoint": "Lightweight breathable summer dress",
                "isExtractPrePoint": false,
                "resolution": "2K",
                "aspectRatio": "1:1",
                "noText": false,
                "brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
                "quality": "medium",
                "sensitiveLibraryId": 1001,
                "replaceLibraryId": 1002,
                "modelImageUrl": "https://example.com/model-reference.jpg",
                "sceneImageUrl": "https://example.com/scene.jpg",
                "isExactScene": true,
                "modelAndSceneInfo": "{\"model\":\"female adult\",\"scene\":\"studio\"}",
                "aPlusNum": 0,
                "aPlusProNum": 0,
                "aPlusHasPhone": false,
                "aPlusAspectRatio": "1:1",
                "modelTypeNum": 0,
                "insTypeNum": 0,
                "sellerTypeNum": 0,
                "sizeTypeNum": 0,
                "whiteTypeNum": 0,
                "aPlusStyles": [
                  {
                    "id": 1
                  },
                  {
                    "prompt": "clean editorial layout"
                  }
                ],
                "pointStyles": [
                  {
                    "id": 2
                  },
                  {
                    "prompt": "minimal feature callouts"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-apparel-image-set-photography-v3",
        "x-nexscope-mcp-tool-name": "nexscope_ai_apparel_image_set_photography_v3",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/ai-model-pose-generation/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "AI Model Pose Generation API",
        "description": "Generate model pose variations from an input image and either a pose prompt or posture reference image.",
        "operationId": "runAiModelPoseGeneration",
        "externalDocs": {
          "description": "AI Model Pose Generation API documentation",
          "url": "https://www.nexscope.ai/api-docs/ai-model-pose-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate model pose variations from an input image and either a pose prompt or posture reference image.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the model image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.",
                    "example": "https://example.com/model-reference.jpg"
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Text prompt describing the target pose.",
                    "example": "standing naturally with one hand holding the product"
                  },
                  "postureUrl": {
                    "type": "string",
                    "description": "Optional posture reference image URL.",
                    "example": "https://example.com/pose.jpg"
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate, from 1 to 4. Defaults to 1.",
                    "example": 1
                  }
                },
                "required": [
                  "imageUrl"
                ],
                "example": {
                  "imageUrl": "https://example.com/model-reference.jpg",
                  "prompt": "standing naturally with one hand holding the product",
                  "postureUrl": "https://example.com/pose.jpg",
                  "outputNum": 1
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/model-reference.jpg",
                "prompt": "standing naturally with one hand holding the product",
                "postureUrl": "https://example.com/pose.jpg",
                "outputNum": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "ai-model-pose-generation",
        "x-nexscope-mcp-tool-name": "nexscope_ai_model_pose_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/sales-talking-video/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Sales Talking Video API",
        "description": "Create a product-selling video from prompt and product image references.",
        "operationId": "runSalesTalkingVideo",
        "externalDocs": {
          "description": "Sales Talking Video API documentation",
          "url": "https://www.nexscope.ai/api-docs/sales-talking-video"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Create a product-selling video from prompt and product image references.",
                "properties": {
                  "prompt": {
                    "type": "string",
                    "description": "Sales script or creative prompt.",
                    "example": "Introduce this shockproof phone case in an upbeat tone."
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public product image URLs. Provide up to 30 images for Seedance 2.5 or up to 9 images for the other supported models.",
                    "example": [
                      "https://example.com/product.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 30
                  },
                  "videoType": {
                    "type": "string",
                    "description": "Video model. Supported values: seedance-2-0, seedance-2-0-fast, seedance-2-0-mini, seedance-2-5, or happyhorse-v2.",
                    "example": "seedance-2-0-fast"
                  },
                  "videoTime": {
                    "type": "integer",
                    "description": "Target duration in seconds. Seedance 2.0, Fast, Mini, and HappyHorse V2 support 5, 10, or 15; Seedance 2.5 also supports 30.",
                    "example": 10
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target aspect ratio: 16:9, 9:16, 1:1, 4:3, 3:4, or 21:9.",
                    "example": "9:16"
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Enable Pro mode for any Seedance model. HappyHorse V2 does not support Pro mode. When enabled without resolution, the default is 720p.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Target resolution. Seedance 2.0 and 2.5 support 480p, 720p, or 1080p; Seedance Fast and Mini support 480p or 720p; HappyHorse V2 supports 720p or 1080p.",
                    "example": "720p"
                  }
                },
                "required": [
                  "prompt",
                  "imageList",
                  "videoType"
                ],
                "example": {
                  "prompt": "Introduce this shockproof phone case in an upbeat tone.",
                  "imageList": [
                    "https://example.com/product.jpg"
                  ],
                  "videoType": "seedance-2-0-fast",
                  "videoTime": 10,
                  "aspectRatio": "9:16",
                  "isPro": false,
                  "resolution": "720p"
                },
                "additionalProperties": true
              },
              "example": {
                "prompt": "Introduce this shockproof phone case in an upbeat tone.",
                "imageList": [
                  "https://example.com/product.jpg"
                ],
                "videoType": "seedance-2-0-fast",
                "videoTime": 10,
                "aspectRatio": "9:16",
                "isPro": false,
                "resolution": "720p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "sales-talking-video",
        "x-nexscope-mcp-tool-name": "nexscope_sales_talking_video",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/product-logo-detection-removal/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "Product Logo Detection & Removal API",
        "description": "Detect and optionally remove a specified brand logo from a product image.",
        "operationId": "runProductLogoDetectionRemoval",
        "externalDocs": {
          "description": "Product Logo Detection & Removal API documentation",
          "url": "https://www.nexscope.ai/api-docs/product-logo-detection-removal"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Detect and optionally remove a specified brand logo from a product image.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the product image. The image must be up to 20 MB.",
                    "example": "https://example.com/product.jpg"
                  },
                  "brandName": {
                    "type": "string",
                    "description": "Brand name to detect or remove.",
                    "example": "SampleBrand"
                  },
                  "isDetect": {
                    "type": "boolean",
                    "description": "Whether to only detect instead of removing.",
                    "example": false
                  }
                },
                "required": [
                  "imageUrl",
                  "brandName"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "brandName": "SampleBrand",
                  "isDetect": false
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "brandName": "SampleBrand",
                "isDetect": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "product-logo-detection-removal",
        "x-nexscope-mcp-tool-name": "nexscope_product_logo_detection_removal",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/one-click-image-recoloring-v2/run": {
      "post": {
        "tags": [
          "Multimodal AI"
        ],
        "summary": "One-Click Image Recoloring API v2",
        "description": "Recolor the requested subject using one or more target colors.",
        "operationId": "runOneClickImageRecoloringV2",
        "externalDocs": {
          "description": "One-Click Image Recoloring API v2 documentation",
          "url": "https://www.nexscope.ai/api-docs/one-click-image-recoloring-v2"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Recolor the requested subject using one or more target colors.",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of the product image. The image must be between 300 and 4096 pixels in both width and height.",
                    "example": "https://example.com/product.jpg"
                  },
                  "colors": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Target colors, from 1 to 25 entries. Each value must use full HEX (#RRGGBB), HSB (hsb(H, S%, B%)), or RGB (rgb(R, G, B)) format. Provide colors or refImageUrls, but not both.",
                    "example": [
                      "#000000",
                      "#FFFFFF"
                    ],
                    "minItems": 1,
                    "maxItems": 25
                  },
                  "refImageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Reference image URLs for reference-image recoloring, from 1 to 25 entries. Provide refImageUrls or colors, but not both.",
                    "example": [
                      "https://example.com/color-reference.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 25
                  },
                  "colorSubject": {
                    "type": "string",
                    "description": "Subject to recolor.",
                    "example": "phone case"
                  }
                },
                "required": [
                  "imageUrl",
                  "colorSubject"
                ],
                "example": {
                  "imageUrl": "https://example.com/product.jpg",
                  "colors": [
                    "#000000",
                    "#FFFFFF"
                  ],
                  "colorSubject": "phone case"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrl": "https://example.com/product.jpg",
                "colors": [
                  "#000000",
                  "#FFFFFF"
                ],
                "colorSubject": "phone case"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "one-click-image-recoloring-v2",
        "x-nexscope-mcp-tool-name": "nexscope_one_click_image_recoloring_v2",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/minimax-h3-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "MiniMax H3 Video Generation",
        "description": "Generate a MiniMax H3 video from 1 to 9 required reference images. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runMinimaxH3VideoGeneration",
        "externalDocs": {
          "description": "MiniMax H3 Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/minimax-h3-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a MiniMax H3 video from 1 to 9 required reference images.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 5, 10, 15.",
                    "example": 5
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 768p, 2k.",
                    "example": "768p"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 9 images.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 9
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: adaptive, 9:16, 16:9, 1:1, 4:3, 3:4, 21:9.",
                    "example": "adaptive"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt",
                  "resolution",
                  "imageList"
                ],
                "example": {
                  "videoTime": 5,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageList": [
                    "https://example.com/product.jpg",
                    "https://example.com/ref-2.jpg"
                  ],
                  "resolution": "768p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 5,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageList": [
                  "https://example.com/product.jpg",
                  "https://example.com/ref-2.jpg"
                ],
                "resolution": "768p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "minimax-h3-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_minimax_h3_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/minimax-h3-lite-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "MiniMax H3 Lite Video Generation",
        "description": "Generate a MiniMax H3 Lite video from 1 to 9 required reference images. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runMinimaxH3LiteVideoGeneration",
        "externalDocs": {
          "description": "MiniMax H3 Lite Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/minimax-h3-lite-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a MiniMax H3 Lite video from 1 to 9 required reference images.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 5, 10, 15.",
                    "example": 5
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 768p.",
                    "example": "768p"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 9 images.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 9
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: adaptive, 9:16, 16:9, 1:1, 4:3, 3:4, 21:9.",
                    "example": "adaptive"
                  }
                },
                "required": [
                  "videoTime",
                  "prompt",
                  "resolution",
                  "imageList"
                ],
                "example": {
                  "videoTime": 5,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageList": [
                    "https://example.com/product.jpg",
                    "https://example.com/ref-2.jpg"
                  ],
                  "resolution": "768p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 5,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageList": [
                  "https://example.com/product.jpg",
                  "https://example.com/ref-2.jpg"
                ],
                "resolution": "768p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "minimax-h3-lite-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_minimax_h3_lite_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/wan-3-video-generation/run": {
      "post": {
        "tags": [
          "Video Generation Models"
        ],
        "summary": "Wan 3 Video Generation",
        "description": "Generate a Wan 3 video from up to 10 image references, first and final frames, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.",
        "operationId": "runWan3VideoGeneration",
        "externalDocs": {
          "description": "Wan 3 Video Generation documentation",
          "url": "https://www.nexscope.ai/api-docs/wan-3-video-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Generate a Wan 3 video from up to 10 image references, first and final frames, or a reference video.",
                "properties": {
                  "videoTime": {
                    "type": "integer",
                    "description": "Video duration in seconds. Supported values: 5, 10, 15, 20, 25, 30.",
                    "example": 5
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.",
                    "example": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                    "maxLength": 2000
                  },
                  "promptOptimizer": {
                    "type": "boolean",
                    "description": "Whether Nexscope should optimize the video prompt before generation. Defaults to false.",
                    "example": false
                  },
                  "isPro": {
                    "type": "boolean",
                    "description": "Whether to use the model's professional generation mode when supported. Defaults to false.",
                    "example": false
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 480p, 720p, 1080p.",
                    "example": "480p"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "Public URL of a first-frame or primary reference image.",
                    "example": "https://example.com/source-image.jpg"
                  },
                  "imageList": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public reference image URLs. Provide 1 to 10 images.",
                    "example": [
                      "https://example.com/product.jpg",
                      "https://example.com/ref-2.jpg"
                    ],
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16.",
                    "example": "16:9"
                  },
                  "lastFrameImageUrl": {
                    "type": "string",
                    "description": "Optional public URL of the final-frame image. Use imageUrl for the first frame; do not combine first-and-last-frame mode with imageList or video.",
                    "example": "https://example.com/last-frame.jpg"
                  },
                  "video": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.",
                    "example": [
                      "https://example.com/reference-video.mp4"
                    ],
                    "minItems": 1
                  }
                },
                "required": [
                  "videoTime",
                  "prompt",
                  "resolution"
                ],
                "example": {
                  "videoTime": 5,
                  "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                  "imageUrl": "https://example.com/source-image.jpg",
                  "resolution": "480p"
                },
                "additionalProperties": true
              },
              "example": {
                "videoTime": 5,
                "prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
                "imageUrl": "https://example.com/source-image.jpg",
                "resolution": "480p"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "wan-3-video-generation",
        "x-nexscope-mcp-tool-name": "nexscope_wan_3_video_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/shopee-product-detail/run": {
      "post": {
        "tags": [
          "Shopee Marketplace"
        ],
        "summary": "Shopee Product Detail",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "runShopeeProductDetail",
        "externalDocs": {
          "description": "Shopee Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/shopee-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "productUrl"
                ],
                "properties": {
                  "productUrl": {
                    "type": "string",
                    "format": "uri",
                    "pattern": "^https://(?:shopee\\.sg|shopee\\.co\\.id|shopee\\.com\\.my|shopee\\.ph|shopee\\.co\\.th|shopee\\.tw|shopee\\.vn|shopee\\.com\\.br)(?::443)?/[^?#]*-i\\.\\d+\\.\\d+/?(?:[?#].*)?$"
                  }
                },
                "description": "Request parameters documented by ecommerce.shopee-product-detail.",
                "example": {
                  "productUrl": "https://shopee.sg/example-i.9641401.29691169956"
                }
              },
              "example": {
                "productUrl": "https://shopee.sg/example-i.9641401.29691169956"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "product"
                          ],
                          "properties": {
                            "product": {
                              "type": "object",
                              "additionalProperties": true,
                              "required": [
                                "itemId",
                                "shopId"
                              ],
                              "properties": {
                                "itemId": {
                                  "type": "string"
                                },
                                "shopId": {
                                  "type": "string"
                                },
                                "url": {
                                  "type": "string"
                                },
                                "name": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "brand": {
                                  "type": [
                                    "string",
                                    "object",
                                    "null"
                                  ]
                                },
                                "category": {
                                  "type": [
                                    "string",
                                    "object",
                                    "array",
                                    "null"
                                  ]
                                },
                                "images": {
                                  "anyOf": [
                                    {
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "videos": {
                                  "type": "array"
                                },
                                "price": {
                                  "type": [
                                    "number",
                                    "object",
                                    "null"
                                  ]
                                },
                                "currency": {
                                  "type": "string"
                                },
                                "sold": {
                                  "type": [
                                    "integer",
                                    "number",
                                    "null"
                                  ]
                                },
                                "rating": {
                                  "type": [
                                    "number",
                                    "null"
                                  ]
                                },
                                "stock": {
                                  "type": [
                                    "integer",
                                    "number",
                                    "object",
                                    "null"
                                  ]
                                },
                                "models": {
                                  "anyOf": [
                                    {
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "product": {
                      "images": [],
                      "models": [],
                      "shopId": "9641401",
                      "itemId": "29691169956",
                      "name": "Example Shopee product"
                    }
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "shopee-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_shopee_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/1688-product-detail/run": {
      "post": {
        "tags": [
          "1688 Sourcing"
        ],
        "summary": "1688 Product Detail",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "run1688ProductDetail",
        "externalDocs": {
          "description": "1688 Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/1688-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "offerId"
                ],
                "properties": {
                  "offerId": {
                    "type": "string",
                    "pattern": "^[1-9]\\d{0,999}$"
                  },
                  "currency": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{3}$"
                  }
                },
                "description": "Request parameters documented by ecommerce.1688-product-detail.",
                "example": {
                  "offerId": "1040473674152"
                }
              },
              "example": {
                "offerId": "1040473674152"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "product"
                          ],
                          "properties": {
                            "product": {
                              "type": "object",
                              "additionalProperties": true,
                              "required": [
                                "offerId"
                              ],
                              "properties": {
                                "offerId": {
                                  "type": "string"
                                },
                                "subject": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "description": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "productUrl": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "skuList": {
                                  "anyOf": [
                                    {
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "saleInfo": {
                                  "anyOf": [
                                    {
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "shippingInfo": {
                                  "anyOf": [
                                    {
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "companyName": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "product": {
                      "offerId": "1040473674152",
                      "subject": "Example 1688 product",
                      "skuList": [],
                      "companyName": "Example supplier",
                      "saleInfo": {},
                      "shippingInfo": {}
                    }
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "1688-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_1688_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/mercado-market-intelligence/run": {
      "post": {
        "tags": [
          "Product & Market Research"
        ],
        "summary": "Mercado Market Intelligence",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "runMercadoMarketIntelligence",
        "externalDocs": {
          "description": "Mercado Market Intelligence documentation",
          "url": "https://www.nexscope.ai/api-docs/mercado-market-intelligence"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "unevaluatedProperties": false,
                "required": [
                  "toolName",
                  "arguments"
                ],
                "discriminator": {
                  "propertyName": "toolName"
                },
                "oneOf": [
                  {
                    "properties": {
                      "toolName": {
                        "const": "search_categories"
                      },
                      "arguments": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "market_code": {
                            "$ref": "#/$defs/marketCode"
                          },
                          "query": {
                            "type": "string"
                          },
                          "limit": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 100
                          }
                        }
                      }
                    },
                    "required": [
                      "toolName",
                      "arguments"
                    ]
                  },
                  {
                    "properties": {
                      "toolName": {
                        "const": "industry_overview"
                      },
                      "arguments": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "category_id"
                        ],
                        "properties": {
                          "category_id": {
                            "type": "string",
                            "minLength": 1
                          },
                          "market_code": {
                            "$ref": "#/$defs/marketCode"
                          }
                        }
                      }
                    },
                    "required": [
                      "toolName",
                      "arguments"
                    ]
                  },
                  {
                    "properties": {
                      "toolName": {
                        "const": "search_product_snapshots"
                      },
                      "arguments": {
                        "$ref": "#/$defs/snapshots"
                      }
                    },
                    "required": [
                      "toolName",
                      "arguments"
                    ]
                  },
                  {
                    "properties": {
                      "toolName": {
                        "const": "product_sales_trend"
                      },
                      "arguments": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "sku_id"
                        ],
                        "properties": {
                          "sku_id": {
                            "type": "string",
                            "minLength": 1
                          },
                          "market_code": {
                            "$ref": "#/$defs/marketCode"
                          },
                          "days": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 731,
                            "default": 730
                          }
                        }
                      }
                    },
                    "required": [
                      "toolName",
                      "arguments"
                    ]
                  },
                  {
                    "properties": {
                      "toolName": {
                        "const": "image_search_products"
                      },
                      "arguments": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "image_url": {
                            "type": "string",
                            "format": "uri",
                            "pattern": "^https?://"
                          },
                          "image_base64": {
                            "type": "string",
                            "minLength": 1
                          },
                          "market_code": {
                            "$ref": "#/$defs/marketCode"
                          },
                          "page": {
                            "type": "integer",
                            "minimum": 1,
                            "default": 1
                          },
                          "limit": {
                            "type": "integer",
                            "minimum": 1,
                            "default": 50
                          }
                        },
                        "anyOf": [
                          {
                            "required": [
                              "image_url"
                            ]
                          },
                          {
                            "required": [
                              "image_base64"
                            ]
                          }
                        ]
                      }
                    },
                    "required": [
                      "toolName",
                      "arguments"
                    ]
                  },
                  {
                    "properties": {
                      "toolName": {
                        "const": "review_search"
                      },
                      "arguments": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "sku_id"
                        ],
                        "properties": {
                          "sku_id": {
                            "type": "string",
                            "minLength": 1
                          },
                          "market_code": {
                            "$ref": "#/$defs/marketCode"
                          },
                          "page": {
                            "type": "integer",
                            "minimum": 1,
                            "default": 1
                          },
                          "limit": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100,
                            "default": 20
                          }
                        }
                      }
                    },
                    "required": [
                      "toolName",
                      "arguments"
                    ]
                  }
                ],
                "$defs": {
                  "marketCode": {
                    "type": "string",
                    "enum": [
                      "MLM",
                      "MLB",
                      "MLA",
                      "MLC",
                      "MCO"
                    ],
                    "default": "MLM"
                  },
                  "snapshots": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "market_code": {
                        "$ref": "#/$defs/marketCode"
                      },
                      "keyword": {
                        "type": "string"
                      },
                      "category_id": {
                        "type": "string"
                      },
                      "sku_id": {
                        "type": "string"
                      },
                      "product_url": {
                        "type": "string",
                        "format": "uri",
                        "pattern": "^https?://"
                      },
                      "shop_id": {
                        "type": "string"
                      },
                      "shop_query": {
                        "type": "string"
                      },
                      "price_min": {
                        "type": "number",
                        "minimum": 0
                      },
                      "price_max": {
                        "type": "number",
                        "minimum": 0
                      },
                      "sales_30d_min": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "sales_30d_max": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "historical_total_sales_min": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "historical_total_sales_max": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "review_count_min": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "review_count_max": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "rating_min": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 5
                      },
                      "rating_max": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 5
                      },
                      "listing_date_min": {
                        "type": "string",
                        "pattern": "^\\d{8}$|^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      "listing_date_max": {
                        "type": "string",
                        "pattern": "^\\d{8}$|^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      "stock_type": {
                        "type": "string"
                      },
                      "shop_type": {
                        "type": "string",
                        "enum": [
                          "cross_border",
                          "local"
                        ]
                      },
                      "product_status": {
                        "type": [
                          "string",
                          "integer"
                        ]
                      },
                      "sort_by": {
                        "type": "string",
                        "enum": [
                          "sales_30d",
                          "historical_total_sales",
                          "price",
                          "listing_date",
                          "rating",
                          "review_count",
                          "title"
                        ],
                        "default": "sales_30d"
                      },
                      "sort_order": {
                        "type": "string",
                        "enum": [
                          "asc",
                          "desc"
                        ],
                        "default": "desc"
                      },
                      "page": {
                        "type": "integer",
                        "minimum": 1,
                        "default": 1
                      },
                      "limit": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 100,
                        "default": 100
                      }
                    },
                    "anyOf": [
                      {
                        "required": [
                          "keyword"
                        ]
                      },
                      {
                        "required": [
                          "category_id"
                        ]
                      },
                      {
                        "required": [
                          "sku_id"
                        ]
                      },
                      {
                        "required": [
                          "product_url"
                        ]
                      },
                      {
                        "required": [
                          "shop_id"
                        ]
                      },
                      {
                        "required": [
                          "shop_query"
                        ]
                      }
                    ],
                    "x-relations": [
                      "each *_min <= matching *_max"
                    ]
                  }
                },
                "description": "Request parameters documented by ecommerce.mercado-market-intelligence.",
                "example": {
                  "toolName": "search_categories",
                  "arguments": {
                    "market_code": "MLM",
                    "query": "celulares",
                    "limit": 10
                  }
                }
              },
              "example": {
                "toolName": "search_categories",
                "arguments": {
                  "market_code": "MLM",
                  "query": "celulares",
                  "limit": 10
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "operation",
                            "data"
                          ],
                          "properties": {
                            "operation": {
                              "type": "string",
                              "enum": [
                                "search_categories",
                                "industry_overview",
                                "search_product_snapshots",
                                "product_sales_trend",
                                "image_search_products",
                                "review_search"
                              ]
                            },
                            "data": {
                              "type": "object",
                              "additionalProperties": true
                            },
                            "total": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "charged": {
                              "anyOf": [
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "operation": "search_categories",
                    "data": {
                      "record_count": 1,
                      "records": [
                        {
                          "taxonomy_name": "Cell Phones",
                          "taxonomy_code": "MLM1055"
                        }
                      ]
                    },
                    "total": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "mercado-market-intelligence",
        "x-nexscope-mcp-tool-name": "nexscope_mercado_market_intelligence",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-video-rank/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Video Rank",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "runTiktokVideoRank",
        "externalDocs": {
          "description": "TikTok Video Rank documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-video-rank"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "createdByAi": {
                    "enum": [
                      "true",
                      "false"
                    ],
                    "type": "string"
                  },
                  "date": {
                    "format": "date",
                    "type": "string"
                  },
                  "pageNum": {
                    "default": 1,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "pageSize": {
                    "default": 50,
                    "maximum": 100,
                    "minimum": 10,
                    "multipleOf": 10,
                    "type": "integer"
                  },
                  "productCategoryId": {
                    "type": "string"
                  },
                  "rankType": {
                    "enum": [
                      1,
                      2,
                      3
                    ],
                    "type": "integer"
                  },
                  "region": {
                    "enum": [
                      "US",
                      "ID",
                      "TH",
                      "PH",
                      "MY",
                      "VN",
                      "GB",
                      "MX",
                      "SG",
                      "SA",
                      "BR",
                      "ES",
                      "JP",
                      "DE",
                      "IT",
                      "FR"
                    ],
                    "type": "string"
                  },
                  "videoRankField": {
                    "enum": [
                      1,
                      2
                    ],
                    "type": "integer"
                  }
                },
                "required": [
                  "date",
                  "rankType",
                  "region",
                  "videoRankField"
                ],
                "type": "object"
              },
              "example": {
                "date": "2026-08-26",
                "pageNum": 1,
                "pageSize": 50,
                "rankType": 1,
                "region": "US",
                "videoRankField": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "videos",
                            "total"
                          ],
                          "properties": {
                            "videos": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": true,
                                "properties": {
                                  "videoId": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "officialUrl": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "region": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "totalViewsCnt": {
                                    "anyOf": [
                                      {
                                        "type": [
                                          "integer",
                                          "number"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                }
                              }
                            },
                            "total": {
                              "type": "integer",
                              "minimum": 0
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "total": 1,
                    "videos": [
                      {
                        "videoId": "example-video-id",
                        "totalViewsCnt": 1,
                        "region": "US"
                      }
                    ]
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-video-rank",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_video_rank",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/etsy-product-detail/run": {
      "post": {
        "tags": [
          "Etsy Marketplace"
        ],
        "summary": "Etsy Product Detail",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "runEtsyProductDetail",
        "externalDocs": {
          "description": "Etsy Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/etsy-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "productUrl"
                ],
                "properties": {
                  "productUrl": {
                    "type": "string",
                    "format": "uri",
                    "pattern": "^https://(?:[A-Za-z0-9-]+\\.)*etsy\\.com(?::443)?/listing/\\d+(?:/[^/?#]+)?/?(?:[?#].*)?$"
                  }
                },
                "description": "Request parameters documented by ecommerce.etsy-product-detail.",
                "example": {
                  "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"
                }
              },
              "example": {
                "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "product"
                          ],
                          "properties": {
                            "product": {
                              "type": "object",
                              "additionalProperties": true,
                              "required": [
                                "productId"
                              ],
                              "properties": {
                                "productId": {
                                  "type": "string"
                                },
                                "productUrl": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "title": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "description": {
                                  "anyOf": [
                                    {
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "images": {
                                  "anyOf": [
                                    {
                                      "type": "array"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "price": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "currency": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "shopId": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "product": {
                      "images": [],
                      "currency": "EUR",
                      "productId": "1710567856",
                      "price": "24.99",
                      "title": "Example Etsy product"
                    }
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "etsy-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_etsy_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/google-patent-search/run": {
      "post": {
        "tags": [
          "Patent & IP Risk"
        ],
        "summary": "Google Patent Search",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "runGooglePatentSearch",
        "externalDocs": {
          "description": "Google Patent Search documentation",
          "url": "https://www.nexscope.ai/api-docs/google-patent-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "q"
                ],
                "properties": {
                  "q": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "num": {
                    "type": "integer",
                    "minimum": 10,
                    "maximum": 100,
                    "default": 10
                  },
                  "page": {
                    "type": "integer",
                    "minimum": 1,
                    "default": 1
                  },
                  "country": {
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "before": {
                    "type": "string",
                    "pattern": "^(priority|filing|publication):\\d{8}$"
                  },
                  "after": {
                    "type": "string",
                    "pattern": "^(priority|filing|publication):\\d{8}$"
                  },
                  "sort": {
                    "type": "string",
                    "enum": [
                      "new",
                      "old"
                    ]
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "PATENT",
                      "DESIGN"
                    ]
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "GRANT",
                      "APPLICATION"
                    ]
                  },
                  "patents": {
                    "type": "boolean",
                    "default": true
                  },
                  "scholar": {
                    "type": "boolean",
                    "default": false
                  },
                  "litigation": {
                    "type": "string",
                    "enum": [
                      "YES",
                      "NO"
                    ]
                  },
                  "inventor": {
                    "type": "string"
                  },
                  "assignee": {
                    "type": "string"
                  },
                  "clustered": {
                    "const": true
                  },
                  "dups": {
                    "const": "language"
                  }
                },
                "description": "Request parameters documented by ecommerce.google-patent-search.",
                "example": {
                  "q": "wireless earbuds",
                  "num": 10,
                  "page": 1
                }
              },
              "example": {
                "q": "wireless earbuds",
                "num": 10,
                "page": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "results"
                          ],
                          "properties": {
                            "results": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": true
                              }
                            },
                            "searchInformation": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "pagination": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "summary": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "summary": {
                      "cpc": [
                        {
                          "key": "Total",
                          "percentage": 100
                        }
                      ]
                    },
                    "results": []
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "google-patent-search",
        "x-nexscope-mcp-tool-name": "nexscope_google_patent_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/walmart-category-market/run": {
      "post": {
        "tags": [
          "Walmart Marketplace Intelligence"
        ],
        "summary": "Walmart Category Market",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "runWalmartCategoryMarket",
        "externalDocs": {
          "description": "Walmart Category Market documentation",
          "url": "https://www.nexscope.ai/api-docs/walmart-category-market"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "unevaluatedProperties": false,
                "required": [
                  "operation"
                ],
                "discriminator": {
                  "propertyName": "operation"
                },
                "oneOf": [
                  {
                    "properties": {
                      "operation": {
                        "const": "tree"
                      }
                    },
                    "required": [
                      "operation"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "searchByName"
                      },
                      "name": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "required": [
                      "operation",
                      "name"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "marketReport"
                      },
                      "nodePath": {
                        "type": "string",
                        "pattern": "^\\d+(?:_\\d+)+$"
                      }
                    },
                    "required": [
                      "operation",
                      "nodePath"
                    ]
                  }
                ],
                "description": "Request parameters documented by ecommerce.walmart-category-market.",
                "example": {
                  "operation": "tree"
                }
              },
              "example": {
                "operation": "tree"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "operation",
                            "value",
                            "requestConsumed"
                          ],
                          "properties": {
                            "operation": {
                              "type": "string"
                            },
                            "value": {},
                            "requestConsumed": {
                              "type": "integer",
                              "minimum": 0
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "operation": "tree",
                    "value": [
                      {
                        "NodeId": "1005862",
                        "Name": "Personal Care"
                      }
                    ],
                    "requestConsumed": 5
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "walmart-category-market",
        "x-nexscope-mcp-tool-name": "nexscope_walmart_category_market",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/walmart-keyword-research/run": {
      "post": {
        "tags": [
          "Walmart Marketplace Intelligence"
        ],
        "summary": "Walmart Keyword Research",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "runWalmartKeywordResearch",
        "externalDocs": {
          "description": "Walmart Keyword Research documentation",
          "url": "https://www.nexscope.ai/api-docs/walmart-keyword-research"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "unevaluatedProperties": false,
                "required": [
                  "operation"
                ],
                "discriminator": {
                  "propertyName": "operation"
                },
                "oneOf": [
                  {
                    "properties": {
                      "operation": {
                        "const": "marketQuery"
                      },
                      "pattern": {
                        "$ref": "#/$defs/pattern"
                      },
                      "pageIndex": {
                        "$ref": "#/$defs/page"
                      },
                      "pageSize": {
                        "$ref": "#/$defs/pageSize"
                      }
                    },
                    "required": [
                      "operation"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "searchByName"
                      },
                      "name": {
                        "type": "string",
                        "minLength": 1
                      },
                      "pageIndex": {
                        "$ref": "#/$defs/page"
                      }
                    },
                    "required": [
                      "operation",
                      "name"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "searchProducts"
                      },
                      "keyword": {
                        "type": "string",
                        "minLength": 1
                      },
                      "pageIndex": {
                        "$ref": "#/$defs/page"
                      },
                      "pageSize": {
                        "$ref": "#/$defs/pageSize"
                      }
                    },
                    "required": [
                      "operation",
                      "keyword"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "detail"
                      },
                      "keyword": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "required": [
                      "operation",
                      "keyword"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "productKeywords"
                      },
                      "productId": {
                        "type": "string",
                        "minLength": 1
                      },
                      "pageIndex": {
                        "$ref": "#/$defs/page"
                      },
                      "pageSize": {
                        "$ref": "#/$defs/pageSize"
                      }
                    },
                    "required": [
                      "operation",
                      "productId"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "relatedKeywords"
                      },
                      "keyword": {
                        "type": "string",
                        "minLength": 1
                      },
                      "pageIndex": {
                        "$ref": "#/$defs/page"
                      },
                      "pageSize": {
                        "$ref": "#/$defs/pageSize"
                      }
                    },
                    "required": [
                      "operation",
                      "keyword"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "favoriteList"
                      },
                      "command": {
                        "oneOf": [
                          {
                            "enum": [
                              "all",
                              "dict"
                            ]
                          },
                          {
                            "type": "string",
                            "pattern": "^dict=.+$"
                          }
                        ]
                      },
                      "pageIndex": {
                        "$ref": "#/$defs/page"
                      }
                    },
                    "required": [
                      "operation",
                      "command"
                    ]
                  }
                ],
                "$defs": {
                  "page": {
                    "type": "integer",
                    "minimum": 1,
                    "default": 1
                  },
                  "pageSize": {
                    "type": "integer",
                    "minimum": 20,
                    "maximum": 200,
                    "default": 20
                  },
                  "range": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "minItems": 1,
                    "maxItems": 2,
                    "x-relation": "first <= second"
                  },
                  "pattern": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "keyword": {
                        "type": "string",
                        "minLength": 1
                      },
                      "rankCondition": {
                        "$ref": "#/$defs/range"
                      },
                      "searchVolumeCondition": {
                        "$ref": "#/$defs/range"
                      }
                    }
                  }
                },
                "description": "Request parameters documented by ecommerce.walmart-keyword-research.",
                "example": {
                  "operation": "searchByName",
                  "name": "wireless earbuds",
                  "pageIndex": 1
                }
              },
              "example": {
                "operation": "searchByName",
                "name": "wireless earbuds",
                "pageIndex": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "operation",
                            "value",
                            "requestConsumed"
                          ],
                          "properties": {
                            "operation": {
                              "type": "string"
                            },
                            "value": {},
                            "requestConsumed": {
                              "type": "integer",
                              "minimum": 0
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "operation": "searchByName",
                    "value": [
                      {
                        "SearchVolume": 1,
                        "Rank": 1,
                        "Keyword": "wireless earbuds"
                      }
                    ],
                    "requestConsumed": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "walmart-keyword-research",
        "x-nexscope-mcp-tool-name": "nexscope_walmart_keyword_research",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/walmart-product-analysis/run": {
      "post": {
        "tags": [
          "Walmart Marketplace Intelligence"
        ],
        "summary": "Walmart Product Analysis",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "runWalmartProductAnalysis",
        "externalDocs": {
          "description": "Walmart Product Analysis documentation",
          "url": "https://www.nexscope.ai/api-docs/walmart-product-analysis"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "unevaluatedProperties": false,
                "required": [
                  "operation"
                ],
                "discriminator": {
                  "propertyName": "operation"
                },
                "oneOf": [
                  {
                    "properties": {
                      "operation": {
                        "const": "searchByName"
                      },
                      "name": {
                        "type": "string",
                        "minLength": 1
                      },
                      "pageIndex": {
                        "type": "integer",
                        "minimum": 1,
                        "default": 1
                      }
                    },
                    "required": [
                      "operation",
                      "name"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "detail"
                      },
                      "productId": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "required": [
                      "operation",
                      "productId"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "trend"
                      },
                      "productId": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "required": [
                      "operation",
                      "productId"
                    ]
                  },
                  {
                    "properties": {
                      "operation": {
                        "const": "salesVolume"
                      },
                      "productId": {
                        "type": "string",
                        "minLength": 1
                      },
                      "queryDate": {
                        "type": "string",
                        "format": "date"
                      },
                      "queryEndDate": {
                        "type": "string",
                        "format": "date"
                      },
                      "pageIndex": {
                        "type": "integer",
                        "minimum": 1,
                        "default": 1
                      }
                    },
                    "required": [
                      "operation",
                      "productId"
                    ],
                    "x-relations": [
                      "queryDate <= queryEndDate; defaults to latest 30 days; start-only ends today"
                    ]
                  }
                ],
                "description": "Request parameters documented by ecommerce.walmart-product-analysis.",
                "example": {
                  "operation": "detail",
                  "productId": "5169493923"
                }
              },
              "example": {
                "operation": "detail",
                "productId": "5169493923"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "operation",
                            "value",
                            "requestConsumed"
                          ],
                          "properties": {
                            "operation": {
                              "type": "string"
                            },
                            "value": {},
                            "requestConsumed": {
                              "type": "integer",
                              "minimum": 0
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "operation": "detail",
                    "value": {
                      "ProductId": "5169493923",
                      "Price": 1,
                      "Title": "Example Walmart product"
                    },
                    "requestConsumed": 1
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "walmart-product-analysis",
        "x-nexscope-mcp-tool-name": "nexscope_walmart_product_analysis",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/tiktok-shop-product-detail/run": {
      "post": {
        "tags": [
          "TikTok / Social Commerce"
        ],
        "summary": "TikTok Shop Product Detail",
        "description": "Returns normalized public ecommerce research data with a fixed read-only provider path.",
        "operationId": "runTiktokShopProductDetail",
        "externalDocs": {
          "description": "TikTok Shop Product Detail documentation",
          "url": "https://www.nexscope.ai/api-docs/tiktok-shop-product-detail"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "productInput"
                ],
                "properties": {
                  "productInput": {
                    "type": "string",
                    "oneOf": [
                      {
                        "pattern": "^\\d{19}$"
                      },
                      {
                        "format": "uri",
                        "pattern": "^https://(?:[A-Za-z0-9-]+\\.)*tiktok\\.com(?::443)?/(?:.*/)?product/\\d{19}(?:[/?#].*)?$"
                      }
                    ]
                  },
                  "region": {
                    "type": "string",
                    "enum": [
                      "US",
                      "GB",
                      "ID",
                      "MY",
                      "TH",
                      "VN",
                      "PH",
                      "SG",
                      "DE",
                      "FR",
                      "IT",
                      "ES"
                    ],
                    "default": "US"
                  }
                },
                "description": "Request parameters documented by ecommerce.tiktok-shop-product-detail.",
                "example": {
                  "productInput": "1729937400435937604",
                  "region": "US"
                }
              },
              "example": {
                "productInput": "1729937400435937604",
                "region": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "product"
                          ],
                          "properties": {
                            "product": {
                              "type": "object",
                              "additionalProperties": true,
                              "required": [
                                "productId"
                              ],
                              "properties": {
                                "productId": {
                                  "type": "string",
                                  "pattern": "^\\d{19}$"
                                },
                                "title": {
                                  "anyOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "seller": {
                                  "anyOf": [
                                    {
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "pricing": {
                                  "anyOf": [
                                    {
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "sales": {
                                  "anyOf": [
                                    {
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "inventory": {
                                  "anyOf": [
                                    {
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "media": {
                                  "anyOf": [
                                    {
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "product": {
                      "seller": {
                        "name": "CARER SPARK"
                      },
                      "title": "Example TikTok Shop product",
                      "productId": "1729937400435937604"
                    }
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "tiktok-shop-product-detail",
        "x-nexscope-mcp-tool-name": "nexscope_tiktok_shop_product_detail",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-metrics/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "SEO Keyword Metrics",
        "description": "Keyword metrics with explicit coverage for every input. Calls are idempotent by user, slug and UUID key. Free owner-only result retrieval: GET /api/skill-api/v1/skills/seo-keyword-metrics/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. Examples describe structure only and are not measured results.",
        "operationId": "runSeoKeywordMetrics",
        "externalDocs": {
          "description": "SEO Keyword Metrics documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-metrics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "market": {
                    "enum": [
                      "US"
                    ],
                    "type": "string"
                  },
                  "language": {
                    "enum": [
                      "en"
                    ],
                    "type": "string"
                  },
                  "keywords": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "description": "Trimmed, at most ten whitespace-separated words.",
                      "maxLength": 80,
                      "type": "string",
                      "minLength": 1
                    },
                    "minItems": 1
                  }
                },
                "type": "object",
                "required": [
                  "market",
                  "language",
                  "keywords"
                ]
              },
              "example": {
                "language": "en",
                "keywords": [
                  "hiking bottle"
                ],
                "market": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                },
                                "result": {
                                  "anyOf": [
                                    {
                                      "properties": {
                                        "market": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "language": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "items": {
                                          "items": {
                                            "properties": {
                                              "inputIndex": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ]
                                              },
                                              "inputKeyword": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "normalizedKeyword": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "status": {
                                                "enum": [
                                                  "AVAILABLE",
                                                  "NO_COVERAGE"
                                                ],
                                                "type": "string"
                                              },
                                              "searchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ]
                                              },
                                              "cpcUsd": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "competition": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ]
                                              },
                                              "competitionLevel": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "keywordDifficulty": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ]
                                              },
                                              "monthlySearches": {
                                                "items": {
                                                  "properties": {
                                                    "year": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ]
                                                    },
                                                    "month": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ]
                                                    },
                                                    "searchVolume": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ]
                                                    }
                                                  },
                                                  "type": "object"
                                                },
                                                "type": "array"
                                              },
                                              "dataUpdatedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ]
                                              },
                                              "missing": {
                                                "items": {
                                                  "properties": {
                                                    "field": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "reason": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    }
                                                  },
                                                  "type": "object"
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "type": "object"
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "reason": {
                                  "description": "Stable reason on errors 42001 through 42011; accepted errors retain callId.",
                                  "type": "string"
                                },
                                "retryable": {
                                  "const": false,
                                  "type": "boolean"
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-metrics",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_metrics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-expand/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "SEO Keyword Expansion",
        "description": "Deduplicated suggestions and related keywords with source relationships. Calls are idempotent by user, slug and UUID key. Free owner-only result retrieval: GET /api/skill-api/v1/skills/seo-keyword-expand/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. Examples describe structure only and are not measured results.",
        "operationId": "runSeoKeywordExpand",
        "externalDocs": {
          "description": "SEO Keyword Expansion documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-expand"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "market": {
                    "enum": [
                      "US"
                    ],
                    "type": "string"
                  },
                  "language": {
                    "enum": [
                      "en"
                    ],
                    "type": "string"
                  },
                  "keyword": {
                    "description": "Trimmed, at most ten whitespace-separated words.",
                    "maxLength": 80,
                    "type": "string",
                    "minLength": 1
                  },
                  "limit": {
                    "type": "integer",
                    "default": 10,
                    "maximum": 20,
                    "minimum": 1
                  },
                  "sources": {
                    "minItems": 1,
                    "type": "array",
                    "maxItems": 2,
                    "items": {
                      "enum": [
                        "suggestions",
                        "related"
                      ],
                      "type": "string"
                    },
                    "default": [
                      "suggestions",
                      "related"
                    ],
                    "uniqueItems": true
                  }
                },
                "type": "object",
                "required": [
                  "market",
                  "language",
                  "keyword"
                ]
              },
              "example": {
                "keyword": "hiking bottle",
                "language": "en",
                "market": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                },
                                "result": {
                                  "anyOf": [
                                    {
                                      "properties": {
                                        "seed": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "market": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "language": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "requestedLimit": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ]
                                        },
                                        "returnedCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ]
                                        },
                                        "items": {
                                          "items": {
                                            "properties": {
                                              "keyword": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "relations": {
                                                "items": {
                                                  "properties": {
                                                    "source": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "seed": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "depth": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ]
                                                    }
                                                  },
                                                  "type": "object"
                                                },
                                                "type": "array"
                                              },
                                              "searchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ]
                                              },
                                              "keywordDifficulty": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ]
                                              },
                                              "missing": {
                                                "items": {
                                                  "properties": {
                                                    "field": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "reason": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    }
                                                  },
                                                  "type": "object"
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "type": "object"
                                          },
                                          "type": "array"
                                        },
                                        "sources": {
                                          "items": {
                                            "properties": {
                                              "source": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "status": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "returnedCount": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ]
                                              },
                                              "missingReason": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              }
                                            },
                                            "type": "object"
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "reason": {
                                  "description": "Stable reason on errors 42001 through 42011; accepted errors retain callId.",
                                  "type": "string"
                                },
                                "retryable": {
                                  "const": false,
                                  "type": "boolean"
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-expand",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_expand",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-serp/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "SEO SERP",
        "description": "Google result types and original ranks for US English desktop searches. Calls are idempotent by user, slug and UUID key. Free owner-only result retrieval: GET /api/skill-api/v1/skills/seo-serp/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. Examples describe structure only and are not measured results.",
        "operationId": "runSeoSerp",
        "externalDocs": {
          "description": "SEO SERP documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-serp"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "market": {
                    "enum": [
                      "US"
                    ],
                    "type": "string"
                  },
                  "language": {
                    "enum": [
                      "en"
                    ],
                    "type": "string"
                  },
                  "keyword": {
                    "description": "Trimmed, at most ten whitespace-separated words.",
                    "maxLength": 80,
                    "type": "string",
                    "minLength": 1
                  },
                  "limit": {
                    "type": "integer",
                    "default": 10,
                    "maximum": 10,
                    "minimum": 1
                  },
                  "device": {
                    "default": "desktop",
                    "type": "string",
                    "enum": [
                      "desktop"
                    ]
                  }
                },
                "type": "object",
                "required": [
                  "market",
                  "language",
                  "keyword"
                ]
              },
              "example": {
                "keyword": "hiking bottle",
                "language": "en",
                "market": "US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                },
                                "result": {
                                  "anyOf": [
                                    {
                                      "properties": {
                                        "keyword": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "market": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "language": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "device": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "requestedLimit": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ]
                                        },
                                        "collectedAt": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ]
                                        },
                                        "items": {
                                          "items": {
                                            "properties": {
                                              "type": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ]
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ]
                                              },
                                              "title": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "url": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "domain": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "description": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "missing": {
                                                "items": {
                                                  "properties": {
                                                    "field": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "reason": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    }
                                                  },
                                                  "type": "object"
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "type": "object"
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "reason": {
                                  "description": "Stable reason on errors 42001 through 42011; accepted errors retain callId.",
                                  "type": "string"
                                },
                                "retryable": {
                                  "const": false,
                                  "type": "boolean"
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-serp",
        "x-nexscope-mcp-tool-name": "nexscope_seo_serp",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-page-evidence/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "SEO Page Evidence",
        "description": "Bounded page evidence with separate collection snapshots and missing reasons. Calls are idempotent by user, slug and UUID key. Free owner-only result retrieval: GET /api/skill-api/v1/skills/seo-page-evidence/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. Examples describe structure only and are not measured results.",
        "operationId": "runSeoPageEvidence",
        "externalDocs": {
          "description": "SEO Page Evidence documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-page-evidence"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "description": "Public HTTP(S) URL only; no credentials, IP literals or nonstandard ports.",
                    "maxLength": 2048,
                    "type": "string",
                    "minLength": 1
                  }
                },
                "type": "object",
                "required": [
                  "url"
                ]
              },
              "example": {
                "url": "https://example.com/"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                },
                                "result": {
                                  "anyOf": [
                                    {
                                      "properties": {
                                        "requestedUrl": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "snapshots": {
                                          "items": {
                                            "properties": {
                                              "id": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "sourceEndpoint": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "capturedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ]
                                              },
                                              "status": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "finalUrl": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "evidence": {
                                                "anyOf": [
                                                  {
                                                    "properties": {
                                                      "httpStatus": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ]
                                                      },
                                                      "title": {
                                                        "type": [
                                                          "string",
                                                          "null"
                                                        ]
                                                      },
                                                      "description": {
                                                        "type": [
                                                          "string",
                                                          "null"
                                                        ]
                                                      },
                                                      "canonical": {
                                                        "type": [
                                                          "string",
                                                          "null"
                                                        ]
                                                      },
                                                      "h1": {
                                                        "items": {
                                                          "type": [
                                                            "string",
                                                            "null"
                                                          ]
                                                        },
                                                        "type": "array"
                                                      },
                                                      "metaRobots": {
                                                        "items": {
                                                          "type": [
                                                            "string",
                                                            "null"
                                                          ]
                                                        },
                                                        "type": "array"
                                                      },
                                                      "textLength": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ]
                                                      },
                                                      "html": {
                                                        "properties": {
                                                          "content": {
                                                            "type": [
                                                              "string",
                                                              "null"
                                                            ]
                                                          },
                                                          "truncated": {
                                                            "type": "boolean"
                                                          },
                                                          "sha256": {
                                                            "type": [
                                                              "string",
                                                              "null"
                                                            ]
                                                          }
                                                        },
                                                        "type": "object"
                                                      }
                                                    },
                                                    "type": "object"
                                                  },
                                                  {
                                                    "properties": {
                                                      "title": {
                                                        "type": [
                                                          "string",
                                                          "null"
                                                        ]
                                                      },
                                                      "text": {
                                                        "type": [
                                                          "string",
                                                          "null"
                                                        ]
                                                      },
                                                      "links": {
                                                        "items": {
                                                          "properties": {
                                                            "url": {
                                                              "type": [
                                                                "string",
                                                                "null"
                                                              ]
                                                            },
                                                            "text": {
                                                              "type": [
                                                                "string",
                                                                "null"
                                                              ]
                                                            }
                                                          },
                                                          "type": "object"
                                                        },
                                                        "type": "array"
                                                      },
                                                      "textTruncated": {
                                                        "type": "boolean"
                                                      },
                                                      "linksTruncated": {
                                                        "type": "boolean"
                                                      }
                                                    },
                                                    "type": "object"
                                                  }
                                                ]
                                              },
                                              "missing": {
                                                "items": {
                                                  "properties": {
                                                    "field": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "reason": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    }
                                                  },
                                                  "type": "object"
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "type": "object"
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "type": "object"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "reason": {
                                  "description": "Stable reason on errors 42001 through 42011; accepted errors retain callId.",
                                  "type": "string"
                                },
                                "retryable": {
                                  "const": false,
                                  "type": "boolean"
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-page-evidence",
        "x-nexscope-mcp-tool-name": "nexscope_seo_page_evidence",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-intent/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "Keyword Intent",
        "description": "Keyword Intent with explicit missing evidence and bounded keyword inputs. Uses one fixed Nexscope task. Schema C1-1.0. Idempotent calls preserve original input order. Free owner-only retrieval: GET /api/skill-api/v1/skills/seo-keyword-intent/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. No execution or publication is implied.",
        "operationId": "runSeoKeywordIntent",
        "externalDocs": {
          "description": "Keyword Intent documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-intent"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "keywords": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "minItems": 1
                  },
                  "language": {
                    "const": "en",
                    "type": "string"
                  }
                },
                "type": "object",
                "required": [
                  "keywords",
                  "language"
                ]
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                },
                                "result": {
                                  "anyOf": [
                                    {
                                      "additionalProperties": false,
                                      "properties": {
                                        "language": {
                                          "const": "en",
                                          "type": "string"
                                        },
                                        "items": {
                                          "maxItems": 20,
                                          "type": "array",
                                          "items": {
                                            "additionalProperties": false,
                                            "properties": {
                                              "inputIndex": {
                                                "maximum": 19,
                                                "minimum": 0,
                                                "type": "integer"
                                              },
                                              "inputKeyword": {
                                                "type": "string"
                                              },
                                              "normalizedKeyword": {
                                                "type": "string"
                                              },
                                              "status": {
                                                "enum": [
                                                  "AVAILABLE",
                                                  "NO_COVERAGE"
                                                ],
                                                "type": "string"
                                              },
                                              "primaryIntent": {
                                                "anyOf": [
                                                  {
                                                    "additionalProperties": false,
                                                    "properties": {
                                                      "label": {
                                                        "enum": [
                                                          "informational",
                                                          "navigational",
                                                          "commercial",
                                                          "transactional"
                                                        ],
                                                        "type": "string"
                                                      },
                                                      "probability": {
                                                        "maximum": 1,
                                                        "minimum": 0,
                                                        "type": [
                                                          "number",
                                                          "null"
                                                        ]
                                                      }
                                                    },
                                                    "type": "object",
                                                    "required": [
                                                      "label",
                                                      "probability"
                                                    ]
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "secondaryIntents": {
                                                "items": {
                                                  "additionalProperties": false,
                                                  "properties": {
                                                    "label": {
                                                      "enum": [
                                                        "informational",
                                                        "navigational",
                                                        "commercial",
                                                        "transactional"
                                                      ],
                                                      "type": "string"
                                                    },
                                                    "probability": {
                                                      "maximum": 1,
                                                      "minimum": 0,
                                                      "type": [
                                                        "number",
                                                        "null"
                                                      ]
                                                    }
                                                  },
                                                  "type": "object",
                                                  "required": [
                                                    "label",
                                                    "probability"
                                                  ]
                                                },
                                                "type": "array"
                                              },
                                              "missing": {
                                                "items": {
                                                  "additionalProperties": false,
                                                  "properties": {
                                                    "field": {
                                                      "minLength": 1,
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_KEYWORD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_KEYWORD"
                                                      ],
                                                      "type": "string"
                                                    }
                                                  },
                                                  "type": "object",
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "type": "object",
                                            "required": [
                                              "inputIndex",
                                              "inputKeyword",
                                              "normalizedKeyword",
                                              "status",
                                              "primaryIntent",
                                              "secondaryIntents",
                                              "missing"
                                            ]
                                          },
                                          "minItems": 1
                                        }
                                      },
                                      "type": "object",
                                      "required": [
                                        "language",
                                        "items"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-intent",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_intent",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-ideas/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "Category-based Keyword Ideas",
        "description": "Category-based Keyword Ideas with explicit missing evidence and bounded keyword inputs. Uses one fixed Nexscope task. Schema C1-1.0. Idempotent calls preserve original input order. Free owner-only retrieval: GET /api/skill-api/v1/skills/seo-keyword-ideas/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. No execution or publication is implied.",
        "operationId": "runSeoKeywordIdeas",
        "externalDocs": {
          "description": "Category-based Keyword Ideas documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-ideas"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "keywords": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "minItems": 1
                  },
                  "language": {
                    "const": "en",
                    "type": "string"
                  },
                  "market": {
                    "const": "US",
                    "type": "string"
                  },
                  "limit": {
                    "type": "integer",
                    "default": 10,
                    "maximum": 20,
                    "minimum": 1
                  }
                },
                "type": "object",
                "required": [
                  "keywords",
                  "language",
                  "market"
                ]
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                },
                                "result": {
                                  "anyOf": [
                                    {
                                      "additionalProperties": false,
                                      "properties": {
                                        "seeds": {
                                          "maxItems": 20,
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1
                                        },
                                        "market": {
                                          "const": "US",
                                          "type": "string"
                                        },
                                        "language": {
                                          "const": "en",
                                          "type": "string"
                                        },
                                        "relationSource": {
                                          "const": "category",
                                          "type": "string"
                                        },
                                        "requestedLimit": {
                                          "maximum": 20,
                                          "minimum": 1,
                                          "type": "integer"
                                        },
                                        "returnedCount": {
                                          "maximum": 20,
                                          "minimum": 0,
                                          "type": "integer"
                                        },
                                        "items": {
                                          "maxItems": 20,
                                          "type": "array",
                                          "items": {
                                            "additionalProperties": false,
                                            "properties": {
                                              "keyword": {
                                                "minLength": 1,
                                                "type": "string"
                                              },
                                              "categoryIds": {
                                                "items": {
                                                  "maximum": 2147483647,
                                                  "minimum": 1,
                                                  "type": "integer"
                                                },
                                                "type": "array",
                                                "uniqueItems": true
                                              },
                                              "searchVolume": {
                                                "minimum": 0,
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ]
                                              },
                                              "cpcUsd": {
                                                "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$",
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "competition": {
                                                "maximum": 1,
                                                "minimum": 0,
                                                "type": [
                                                  "number",
                                                  "null"
                                                ]
                                              },
                                              "missing": {
                                                "items": {
                                                  "additionalProperties": false,
                                                  "properties": {
                                                    "field": {
                                                      "minLength": 1,
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_KEYWORD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_KEYWORD"
                                                      ],
                                                      "type": "string"
                                                    }
                                                  },
                                                  "type": "object",
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "type": "object",
                                            "required": [
                                              "keyword",
                                              "categoryIds",
                                              "searchVolume",
                                              "cpcUsd",
                                              "competition",
                                              "missing"
                                            ]
                                          },
                                          "minItems": 0
                                        },
                                        "missing": {
                                          "items": {
                                            "additionalProperties": false,
                                            "properties": {
                                              "field": {
                                                "minLength": 1,
                                                "type": "string"
                                              },
                                              "reason": {
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_KEYWORD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_KEYWORD"
                                                ],
                                                "type": "string"
                                              }
                                            },
                                            "type": "object",
                                            "required": [
                                              "field",
                                              "reason"
                                            ]
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "type": "object",
                                      "required": [
                                        "seeds",
                                        "market",
                                        "language",
                                        "relationSource",
                                        "requestedLimit",
                                        "returnedCount",
                                        "items",
                                        "missing"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-ideas",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_ideas",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-categories/run": {
      "post": {
        "tags": [
          "Search & Trend Intelligence"
        ],
        "summary": "Keyword Categories",
        "description": "Keyword Categories with explicit missing evidence and bounded keyword inputs. Uses one fixed Nexscope task. Schema C1-1.0. Idempotent calls preserve original input order. Free owner-only retrieval: GET /api/skill-api/v1/skills/seo-keyword-categories/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. No execution or publication is implied.",
        "operationId": "runSeoKeywordCategories",
        "externalDocs": {
          "description": "Keyword Categories documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-categories"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "keywords": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "minLength": 1,
                      "type": "string"
                    },
                    "minItems": 1
                  },
                  "language": {
                    "const": "en",
                    "type": "string"
                  }
                },
                "type": "object",
                "required": [
                  "keywords",
                  "language"
                ]
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                },
                                "result": {
                                  "anyOf": [
                                    {
                                      "additionalProperties": false,
                                      "properties": {
                                        "language": {
                                          "const": "en",
                                          "type": "string"
                                        },
                                        "taxonomy": {
                                          "const": "google_product_service",
                                          "type": "string"
                                        },
                                        "items": {
                                          "maxItems": 20,
                                          "type": "array",
                                          "items": {
                                            "additionalProperties": false,
                                            "properties": {
                                              "inputIndex": {
                                                "maximum": 19,
                                                "minimum": 0,
                                                "type": "integer"
                                              },
                                              "inputKeyword": {
                                                "type": "string"
                                              },
                                              "normalizedKeyword": {
                                                "type": "string"
                                              },
                                              "status": {
                                                "enum": [
                                                  "AVAILABLE",
                                                  "NO_COVERAGE"
                                                ],
                                                "type": "string"
                                              },
                                              "categoryIds": {
                                                "items": {
                                                  "maximum": 2147483647,
                                                  "minimum": 1,
                                                  "type": "integer"
                                                },
                                                "type": "array",
                                                "uniqueItems": true
                                              },
                                              "missing": {
                                                "items": {
                                                  "additionalProperties": false,
                                                  "properties": {
                                                    "field": {
                                                      "minLength": 1,
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_KEYWORD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_KEYWORD"
                                                      ],
                                                      "type": "string"
                                                    }
                                                  },
                                                  "type": "object",
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ]
                                                },
                                                "type": "array"
                                              }
                                            },
                                            "type": "object",
                                            "required": [
                                              "inputIndex",
                                              "inputKeyword",
                                              "normalizedKeyword",
                                              "status",
                                              "categoryIds",
                                              "missing"
                                            ]
                                          },
                                          "minItems": 1
                                        }
                                      },
                                      "type": "object",
                                      "required": [
                                        "language",
                                        "taxonomy",
                                        "items"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-categories",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_categories",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-history/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "Keyword Historical Profile Snapshots",
        "description": "Keyword Historical Profile Snapshots. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoKeywordHistory",
        "externalDocs": {
          "description": "Keyword Historical Profile Snapshots documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-history"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    },
                    "minItems": 1,
                    "maxItems": 20
                  },
                  "fromMonth": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}$"
                  },
                  "toMonth": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}$"
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  }
                },
                "required": [
                  "keywords",
                  "fromMonth",
                  "toMonth"
                ],
                "additionalProperties": false
              },
              "example": {
                "toMonth": "2026-03",
                "fromMonth": "2026-01",
                "keywords": [
                  " C ",
                  "d"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "keywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "normalizedKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "fromMonth": {
                                          "type": "string"
                                        },
                                        "toMonth": {
                                          "type": "string"
                                        },
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "history": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "year": {
                                                      "type": "integer",
                                                      "minimum": 1
                                                    },
                                                    "month": {
                                                      "type": "integer",
                                                      "minimum": 1,
                                                      "maximum": 12
                                                    },
                                                    "searchVolume": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "cpcUsd": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ],
                                                      "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                    },
                                                    "paidCompetition": {
                                                      "type": [
                                                        "number",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 1
                                                    },
                                                    "metricsUpdatedAt": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "year",
                                                    "month",
                                                    "searchVolume",
                                                    "cpcUsd",
                                                    "paidCompetition",
                                                    "metricsUpdatedAt",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 12
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "history",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "metricSource": {
                                          "type": "string",
                                          "const": "google_ads_historical_keyword_profile"
                                        },
                                        "timeGranularity": {
                                          "type": "string",
                                          "const": "month"
                                        }
                                      },
                                      "required": [
                                        "keywords",
                                        "normalizedKeywords",
                                        "fromMonth",
                                        "toMonth",
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "metricSource",
                                        "timeGranularity"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-history",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_history",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-site-keywords/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "Site Category Related Keywords",
        "description": "Site Category Related Keywords. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoSiteKeywords",
        "externalDocs": {
          "description": "Site Category Related Keywords documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-site-keywords"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  },
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": " Example.COM. ",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 20
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "relationSource": {
                                          "type": "string",
                                          "const": "site_category"
                                        },
                                        "includeSubdomains": {
                                          "type": "boolean",
                                          "const": true
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "relevance_desc"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "categoryIds": {
                                                "type": "array",
                                                "items": {
                                                  "type": "integer",
                                                  "minimum": 1,
                                                  "maximum": 2147483647
                                                },
                                                "minItems": 0,
                                                "uniqueItems": true
                                              },
                                              "searchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "cpcUsd": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                              },
                                              "competition": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "categoryIds",
                                              "searchVolume",
                                              "cpcUsd",
                                              "competition",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "requestedLimit",
                                        "returnedCount",
                                        "inputTarget",
                                        "target",
                                        "relationSource",
                                        "includeSubdomains",
                                        "ordering",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-site-keywords",
        "x-nexscope-mcp-tool-name": "nexscope_seo_site_keywords",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-category-keywords/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "Category Keywords",
        "description": "Category Keywords. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoCategoryKeywords",
        "externalDocs": {
          "description": "Category Keywords documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-category-keywords"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  },
                  "categoryIds": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 2147483647
                    },
                    "minItems": 1,
                    "maxItems": 20
                  },
                  "categoryMatch": {
                    "type": "string",
                    "enum": [
                      "ALL",
                      "ANY"
                    ],
                    "default": "ALL"
                  }
                },
                "required": [
                  "categoryIds"
                ],
                "additionalProperties": false
              },
              "example": {
                "categoryMatch": "ALL",
                "limit": 3,
                "categoryIds": [
                  12191,
                  12193
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 20
                                        },
                                        "categoryIds": {
                                          "type": "array",
                                          "items": {
                                            "type": "integer",
                                            "minimum": 1
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "normalizedCategoryIds": {
                                          "type": "array",
                                          "items": {
                                            "type": "integer",
                                            "minimum": 1,
                                            "maximum": 2147483647
                                          },
                                          "minItems": 0,
                                          "uniqueItems": true
                                        },
                                        "categoryMatch": {
                                          "type": "string",
                                          "enum": [
                                            "ALL",
                                            "ANY"
                                          ]
                                        },
                                        "taxonomy": {
                                          "type": "string",
                                          "const": "google_product_service"
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "search_volume_desc"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "categoryIds": {
                                                "type": "array",
                                                "items": {
                                                  "type": "integer",
                                                  "minimum": 1,
                                                  "maximum": 2147483647
                                                },
                                                "minItems": 0,
                                                "uniqueItems": true
                                              },
                                              "searchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "cpcUsd": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                              },
                                              "competition": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "categoryIds",
                                              "searchVolume",
                                              "cpcUsd",
                                              "competition",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "requestedLimit",
                                        "returnedCount",
                                        "categoryIds",
                                        "normalizedCategoryIds",
                                        "categoryMatch",
                                        "taxonomy",
                                        "ordering",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-category-keywords",
        "x-nexscope-mcp-tool-name": "nexscope_seo_category_keywords",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-top-searches/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "High Search Volume Database Keywords",
        "description": "High Search Volume Database Keywords. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoTopSearches",
        "externalDocs": {
          "description": "High Search Volume Database Keywords documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-top-searches"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [],
                "minProperties": 1,
                "additionalProperties": false
              },
              "example": {
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "searchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "cpcUsd": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                              },
                                              "paidCompetition": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1
                                              },
                                              "metricsUpdatedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "searchVolume",
                                              "cpcUsd",
                                              "paidCompetition",
                                              "metricsUpdatedAt",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "rankingBasis": {
                                          "type": "string",
                                          "const": "google_ads_search_volume"
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "search_volume_desc"
                                        },
                                        "freshness": {
                                          "type": "string",
                                          "const": "database_latest_available"
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "requestedLimit",
                                        "rankingBasis",
                                        "ordering",
                                        "freshness"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-top-searches",
        "x-nexscope-mcp-tool-name": "nexscope_seo_top_searches",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-clickstream-search-volume/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "Clickstream Search Volume",
        "description": "clickstream estimate with explicit missing evidence and no language filter. One fixed Live task, no additional requests. Estimates are not Google Ads metrics. Prices remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoClickstreamSearchVolume",
        "externalDocs": {
          "description": "Clickstream Search Volume documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-clickstream-search-volume"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "description": "After Unicode trim, 3 to 80 ASCII letters, digits, ordinary spaces, apostrophes or hyphens; at least one letter or digit; at most ten words."
                    },
                    "minItems": 1,
                    "maxItems": 20
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  }
                },
                "required": [
                  "keywords"
                ],
                "additionalProperties": false
              },
              "example": {
                "keywords": [
                  " Shoes ",
                  "shoes"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "normalizedKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "keywords_data"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "clickstream_estimate"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "null"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "averageMonthlySearches": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "months": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "year": {
                                                      "type": "integer",
                                                      "minimum": 1
                                                    },
                                                    "month": {
                                                      "type": "integer",
                                                      "minimum": 1,
                                                      "maximum": 12
                                                    },
                                                    "searchVolume": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "year",
                                                    "month",
                                                    "searchVolume",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 12
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "averageMonthlySearches",
                                              "months",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "inputKeywords",
                                        "normalizedKeywords",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "returnedCount",
                                        "truncated",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-clickstream-search-volume",
        "x-nexscope-mcp-tool-name": "nexscope_seo_clickstream_search_volume",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-search-volume-country-distribution/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "Clickstream Country Search Volume Distribution",
        "description": "clickstream country distribution with explicit missing evidence and no language filter. One fixed Live task, no additional requests. Estimates are not Google Ads metrics. Prices remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoSearchVolumeCountryDistribution",
        "externalDocs": {
          "description": "Clickstream Country Search Volume Distribution documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-search-volume-country-distribution"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "description": "After Unicode trim, 3 to 80 ASCII letters, digits, ordinary spaces, apostrophes or hyphens; at least one letter or digit; at most ten words."
                    },
                    "minItems": 1,
                    "maxItems": 20
                  }
                },
                "required": [
                  "keywords"
                ],
                "additionalProperties": false
              },
              "example": {
                "keywords": [
                  " Shoes ",
                  "shoes"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "normalizedKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "keywords_data"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "clickstream_country_distribution"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "GLOBAL"
                                        },
                                        "languageFilter": {
                                          "type": "null"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "globalAverageMonthlySearches": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "countries": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "countryCode": {
                                                      "type": "string",
                                                      "pattern": "^[A-Z]{2}$"
                                                    },
                                                    "averageMonthlySearches": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "globalPercentage": {
                                                      "type": [
                                                        "number",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 100
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "countryCode",
                                                    "averageMonthlySearches",
                                                    "globalPercentage",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 300
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "globalAverageMonthlySearches",
                                              "countries",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "inputKeywords",
                                        "normalizedKeywords",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "returnedCount",
                                        "truncated",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-search-volume-country-distribution",
        "x-nexscope-mcp-tool-name": "nexscope_seo_search_volume_country_distribution",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-interest-history/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "Keyword Interest History",
        "description": "Nexscope Trends relative interest history for the United States. Scores describe relative interest; zero means insufficient data. Preserve provider dates and do not interpolate search volumes.",
        "operationId": "runSeoKeywordInterestHistory",
        "externalDocs": {
          "description": "Keyword Interest History documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-interest-history"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "description": "After Unicode trim, NFC and lowercase, 1 to 80 code points and at most ten whitespace-separated words; no control characters."
                    },
                    "minItems": 1,
                    "maxItems": 5
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "dateFrom": {
                    "type": "string",
                    "format": "date",
                    "description": "2004-01-01 or later; inclusive interval at most 366 days."
                  },
                  "dateTo": {
                    "type": "string",
                    "format": "date",
                    "description": "No later than first acceptance UTC day; replay retains the frozen dates."
                  }
                },
                "required": [
                  "keywords",
                  "dateFrom",
                  "dateTo"
                ],
                "additionalProperties": false
              },
              "example": {
                "dateTo": "2024-01-02",
                "dateFrom": "2024-01-01",
                "keywords": [
                  " Shoes ",
                  "boots"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 5
                                        },
                                        "normalizedKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 5
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "keywords_data"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_trends_relative"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "null"
                                        },
                                        "dateFrom": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "dateTo": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "averageInterest": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "points": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "dateFrom": {
                                                      "type": "string",
                                                      "format": "date"
                                                    },
                                                    "dateTo": {
                                                      "type": "string",
                                                      "format": "date"
                                                    },
                                                    "observedAt": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "interest": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 100
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "dateFrom",
                                                    "dateTo",
                                                    "observedAt",
                                                    "interest",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 366
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "averageInterest",
                                              "points",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 5
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "zeroMeaning": {
                                          "type": "string",
                                          "const": "insufficient_data"
                                        }
                                      },
                                      "required": [
                                        "inputKeywords",
                                        "normalizedKeywords",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "dateFrom",
                                        "dateTo",
                                        "returnedCount",
                                        "truncated",
                                        "items",
                                        "missing",
                                        "zeroMeaning"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-interest-history",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_interest_history",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-interest-regions/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "Keyword Interest by Region",
        "description": "Nexscope Trends relative keyword interest across United States regions. Regional scores are relative indices, not country percentages or absolute search counts. Preserve provider region IDs.",
        "operationId": "runSeoKeywordInterestRegions",
        "externalDocs": {
          "description": "Keyword Interest by Region documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-interest-regions"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "description": "After Unicode trim, NFC and lowercase, 1 to 80 code points and at most ten whitespace-separated words; no control characters."
                    },
                    "minItems": 1,
                    "maxItems": 5
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "dateFrom": {
                    "type": "string",
                    "format": "date",
                    "description": "2004-01-01 or later; inclusive interval at most 366 days."
                  },
                  "dateTo": {
                    "type": "string",
                    "format": "date",
                    "description": "No later than first acceptance UTC day; replay retains the frozen dates."
                  }
                },
                "required": [
                  "keywords",
                  "dateFrom",
                  "dateTo"
                ],
                "additionalProperties": false
              },
              "example": {
                "dateTo": "2024-01-02",
                "dateFrom": "2024-01-01",
                "keywords": [
                  " Shoes ",
                  "boots"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 5
                                        },
                                        "normalizedKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 5
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "keywords_data"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_trends_region_relative"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "null"
                                        },
                                        "dateFrom": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "dateTo": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "regions": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "geoId": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "geoName": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "interest": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 100
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "geoId",
                                                    "geoName",
                                                    "interest",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 300
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "regions",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 5
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "inputKeywords",
                                        "normalizedKeywords",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "dateFrom",
                                        "dateTo",
                                        "returnedCount",
                                        "truncated",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-interest-regions",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_interest_regions",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-interest-demographics/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "Keyword Interest by Demographic",
        "description": "Nexscope Trends relative keyword interest by age and gender. Each dimension has relative peak-normalized scores. Do not infer population shares, counts, income, or unreturned demographic buckets.",
        "operationId": "runSeoKeywordInterestDemographics",
        "externalDocs": {
          "description": "Keyword Interest by Demographic documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-interest-demographics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "description": "After Unicode trim, NFC and lowercase, 1 to 80 code points and at most ten whitespace-separated words; no control characters."
                    },
                    "minItems": 1,
                    "maxItems": 5
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "dateFrom": {
                    "type": "string",
                    "format": "date",
                    "description": "2004-01-01 or later; inclusive interval at most 366 days."
                  },
                  "dateTo": {
                    "type": "string",
                    "format": "date",
                    "description": "No later than first acceptance UTC day; replay retains the frozen dates."
                  }
                },
                "required": [
                  "keywords",
                  "dateFrom",
                  "dateTo"
                ],
                "additionalProperties": false
              },
              "example": {
                "dateTo": "2024-01-02",
                "dateFrom": "2024-01-01",
                "keywords": [
                  " Shoes ",
                  "boots"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 5
                                        },
                                        "normalizedKeywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 5
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "keywords_data"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_trends_demographic_relative"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "null"
                                        },
                                        "dateFrom": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "dateTo": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "age": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "band": {
                                                      "type": "string",
                                                      "enum": [
                                                        "18-24",
                                                        "25-34",
                                                        "35-44",
                                                        "45-54",
                                                        "55-64"
                                                      ]
                                                    },
                                                    "interest": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 100
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "band",
                                                    "interest",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 5
                                              },
                                              "gender": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "category": {
                                                      "type": "string",
                                                      "enum": [
                                                        "female",
                                                        "male"
                                                      ]
                                                    },
                                                    "interest": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 100
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "category",
                                                    "interest",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 2
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "age",
                                              "gender",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 5
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "inputKeywords",
                                        "normalizedKeywords",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "dateFrom",
                                        "dateTo",
                                        "returnedCount",
                                        "truncated",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-interest-demographics",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_interest_demographics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-search-autocomplete/run": {
      "post": {
        "tags": [
          "Keywords & Trends"
        ],
        "summary": "Google Search Autocomplete",
        "description": "A Google US English autocomplete sample for one keyword. Preserve suggestions from the fixed client. Missing optional fields stay null; no complete search coverage is implied.",
        "operationId": "runSeoSearchAutocomplete",
        "externalDocs": {
          "description": "Google Search Autocomplete documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-search-autocomplete"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "keyword"
                ],
                "additionalProperties": false
              },
              "example": {
                "keyword": " C++ ",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeyword": {
                                          "type": "string"
                                        },
                                        "keyword": {
                                          "type": "string"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "serp"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "google_autocomplete_sample"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "sample": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "observedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "checkUrl": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "observedTypes": {
                                              "type": "array",
                                              "items": {
                                                "type": "string"
                                              }
                                            }
                                          },
                                          "required": [
                                            "observedAt",
                                            "checkUrl",
                                            "observedTypes"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "suggestion": {
                                                "type": "string"
                                              },
                                              "suggestionType": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "searchUrl": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "suggestion",
                                              "suggestionType",
                                              "rankGroup",
                                              "rankAbsolute",
                                              "searchUrl",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "inputKeyword",
                                        "keyword",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "requestedLimit",
                                        "returnedCount",
                                        "truncated",
                                        "sample",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-search-autocomplete",
        "x-nexscope-mcp-tool-name": "nexscope_seo_search_autocomplete",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-historical-serps/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Historical Organic SERP Snapshots",
        "description": "Historical Organic SERP Snapshots. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoHistoricalSerps",
        "externalDocs": {
          "description": "Historical Organic SERP Snapshots documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-historical-serps"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80
                  },
                  "dateFrom": {
                    "type": "string",
                    "format": "date"
                  },
                  "dateTo": {
                    "type": "string",
                    "format": "date"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  }
                },
                "required": [
                  "keyword",
                  "dateFrom",
                  "dateTo"
                ],
                "additionalProperties": false
              },
              "example": {
                "limit": 2,
                "dateTo": "2026-01-02",
                "keyword": "C++",
                "dateFrom": "2026-01-01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "keyword": {
                                          "type": "string"
                                        },
                                        "normalizedKeyword": {
                                          "type": "string"
                                        },
                                        "dateFrom": {
                                          "type": "string"
                                        },
                                        "dateTo": {
                                          "type": "string"
                                        },
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "historical_serp_database"
                                        },
                                        "projection": {
                                          "type": "string",
                                          "const": "organic"
                                        },
                                        "requestedResultsPerSnapshot": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "observedAt": {
                                                "type": "integer",
                                                "minimum": 0
                                              },
                                              "checkUrl": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "correctedKeyword": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "correctionType": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "enum": [
                                                  "did_you_mean",
                                                  "showing_results_for",
                                                  "no_results_found_for",
                                                  null
                                                ]
                                              },
                                              "observedSerpTypes": {
                                                "type": "array",
                                                "items": {
                                                  "type": "string"
                                                },
                                                "minItems": 0,
                                                "maxItems": 10000
                                              },
                                              "organicResults": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "type": {
                                                      "type": "string",
                                                      "const": "organic"
                                                    },
                                                    "url": {
                                                      "type": "string"
                                                    },
                                                    "title": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "description": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "rankGroup": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 1
                                                    },
                                                    "rankAbsolute": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 1
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "type",
                                                    "url",
                                                    "title",
                                                    "description",
                                                    "rankGroup",
                                                    "rankAbsolute",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 20
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "observedAt",
                                              "checkUrl",
                                              "correctedKeyword",
                                              "correctionType",
                                              "observedSerpTypes",
                                              "organicResults",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 31
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "keyword",
                                        "normalizedKeyword",
                                        "dateFrom",
                                        "dateTo",
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "sourceKind",
                                        "projection",
                                        "requestedResultsPerSnapshot",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-historical-serps",
        "x-nexscope-mcp-tool-name": "nexscope_seo_historical_serps",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-google-maps-results/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Google Maps Search Results",
        "description": "A Google Maps US English sample of non-advertising map results. Preserve place identifiers, string CIDs, coordinates, and rating scales. Paid map items are outside this projection.",
        "operationId": "runSeoGoogleMapsResults",
        "externalDocs": {
          "description": "Google Maps Search Results documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-google-maps-results"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "keyword"
                ],
                "additionalProperties": false
              },
              "example": {
                "keyword": " Shoes ",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeyword": {
                                          "type": "string"
                                        },
                                        "keyword": {
                                          "type": "string"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "serp"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "google_maps_sample"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "sample": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "observedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "checkUrl": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "observedTypes": {
                                              "type": "array",
                                              "items": {
                                                "type": "string"
                                              }
                                            }
                                          },
                                          "required": [
                                            "observedAt",
                                            "checkUrl",
                                            "observedTypes"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "title": {
                                                "type": "string"
                                              },
                                              "placeId": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "cid": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "url": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "address": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "category": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "latitude": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": -90,
                                                "maximum": 90
                                              },
                                              "longitude": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": -180,
                                                "maximum": 180
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "rating": {
                                                "type": "object",
                                                "properties": {
                                                  "type": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ]
                                                  },
                                                  "value": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "maximum": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "votes": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "type",
                                                  "value",
                                                  "maximum",
                                                  "votes"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "title",
                                              "placeId",
                                              "cid",
                                              "url",
                                              "address",
                                              "category",
                                              "latitude",
                                              "longitude",
                                              "rankGroup",
                                              "rankAbsolute",
                                              "rating",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "inputKeyword",
                                        "keyword",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "requestedLimit",
                                        "returnedCount",
                                        "truncated",
                                        "sample",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-google-maps-results",
        "x-nexscope-mcp-tool-name": "nexscope_seo_google_maps_results",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-google-local-finder-results/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Google Local Finder Results",
        "description": "A Google Local Finder US English sample of local listings. Preserve paid status and booking links. Do not infer addresses or coordinates from descriptions.",
        "operationId": "runSeoGoogleLocalFinderResults",
        "externalDocs": {
          "description": "Google Local Finder Results documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-google-local-finder-results"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "keyword"
                ],
                "additionalProperties": false
              },
              "example": {
                "keyword": " Shoes ",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeyword": {
                                          "type": "string"
                                        },
                                        "keyword": {
                                          "type": "string"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "serp"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "google_local_finder_sample"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "sample": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "observedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "checkUrl": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "observedTypes": {
                                              "type": "array",
                                              "items": {
                                                "type": "string"
                                              }
                                            }
                                          },
                                          "required": [
                                            "observedAt",
                                            "checkUrl",
                                            "observedTypes"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "title": {
                                                "type": "string"
                                              },
                                              "cid": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "url": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "description": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "phone": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "bookingUrl": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "isPaid": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "rating": {
                                                "type": "object",
                                                "properties": {
                                                  "type": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ]
                                                  },
                                                  "value": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "maximum": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "votes": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "type",
                                                  "value",
                                                  "maximum",
                                                  "votes"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "title",
                                              "cid",
                                              "url",
                                              "description",
                                              "phone",
                                              "bookingUrl",
                                              "isPaid",
                                              "rating",
                                              "rankGroup",
                                              "rankAbsolute",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "inputKeyword",
                                        "keyword",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "requestedLimit",
                                        "returnedCount",
                                        "truncated",
                                        "sample",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-google-local-finder-results",
        "x-nexscope-mcp-tool-name": "nexscope_seo_google_local_finder_results",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-google-news-results/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Google News Search Results",
        "description": "A Google US English news_search sample with publication evidence. Top stories remain observed sample types without expansion. Relative publication labels do not replace timestamps.",
        "operationId": "runSeoGoogleNewsResults",
        "externalDocs": {
          "description": "Google News Search Results documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-google-news-results"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10,
                    "default": 10
                  }
                },
                "required": [
                  "keyword"
                ],
                "additionalProperties": false
              },
              "example": {
                "keyword": " Shoes ",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeyword": {
                                          "type": "string"
                                        },
                                        "keyword": {
                                          "type": "string"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "serp"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "google_news_sample"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "sample": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "observedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "checkUrl": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "observedTypes": {
                                              "type": "array",
                                              "items": {
                                                "type": "string"
                                              }
                                            }
                                          },
                                          "required": [
                                            "observedAt",
                                            "checkUrl",
                                            "observedTypes"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string"
                                              },
                                              "title": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "snippet": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "imageUrl": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "publishedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "publishedLabel": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "title",
                                              "snippet",
                                              "imageUrl",
                                              "publishedAt",
                                              "publishedLabel",
                                              "rankGroup",
                                              "rankAbsolute",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 10
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "projection": {
                                          "type": "string",
                                          "const": "news_search"
                                        }
                                      },
                                      "required": [
                                        "inputKeyword",
                                        "keyword",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "requestedLimit",
                                        "returnedCount",
                                        "truncated",
                                        "sample",
                                        "items",
                                        "missing",
                                        "projection"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-google-news-results",
        "x-nexscope-mcp-tool-name": "nexscope_seo_google_news_results",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-google-image-results/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Google Image Search Results",
        "description": "A Google US English image_search sample with page and image references. Keep page, original image, and cached image URLs distinct. References do not imply image ownership or authorize downloads.",
        "operationId": "runSeoGoogleImageResults",
        "externalDocs": {
          "description": "Google Image Search Results documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-google-image-results"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "keyword"
                ],
                "additionalProperties": false
              },
              "example": {
                "keyword": " Shoes ",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputKeyword": {
                                          "type": "string"
                                        },
                                        "keyword": {
                                          "type": "string"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "serp"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "google_images_sample"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "sample": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "observedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "checkUrl": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "observedTypes": {
                                              "type": "array",
                                              "items": {
                                                "type": "string"
                                              }
                                            }
                                          },
                                          "required": [
                                            "observedAt",
                                            "checkUrl",
                                            "observedTypes"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "pageUrl": {
                                                "type": "string"
                                              },
                                              "imageUrl": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "cachedImageUrl": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "title": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "alt": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "pageUrl",
                                              "imageUrl",
                                              "cachedImageUrl",
                                              "title",
                                              "alt",
                                              "rankGroup",
                                              "rankAbsolute",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "inputKeyword",
                                        "keyword",
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "requestedLimit",
                                        "returnedCount",
                                        "truncated",
                                        "sample",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-google-image-results",
        "x-nexscope-mcp-tool-name": "nexscope_seo_google_image_results",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-reverse-image-results/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Reverse Image Search Results",
        "description": "Reverse Image Search Results. Bounded Google reverse-image search observations with explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved.  Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoReverseImageResults",
        "externalDocs": {
          "description": "Reverse Image Search Results documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-reverse-image-results"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "imageUrl": {
                    "type": "string",
                    "maxLength": 2048,
                    "description": "Public ASCII HTTPS URL without query, fragment, credentials, IP literal or non-default port"
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "imageUrl"
                ],
                "additionalProperties": false
              },
              "example": {
                "imageUrl": "https://example.com/"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "serp"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "google_reverse_image_sample"
                                        },
                                        "marketScope": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "languageFilter": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "inputImageUrl": {
                                          "type": "string"
                                        },
                                        "imageUrl": {
                                          "type": "string"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 20
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "associatedKeyword": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "sample": {
                                          "anyOf": [
                                            {
                                              "type": "null"
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "observedAt": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                },
                                                "checkUrl": {
                                                  "type": [
                                                    "string",
                                                    "null"
                                                  ]
                                                },
                                                "observedTypes": {
                                                  "type": "array",
                                                  "items": {
                                                    "type": "string"
                                                  }
                                                }
                                              },
                                              "required": [
                                                "observedAt",
                                                "checkUrl",
                                                "observedTypes"
                                              ],
                                              "additionalProperties": false
                                            }
                                          ]
                                        },
                                        "items": {
                                          "type": "array",
                                          "maxItems": 20,
                                          "items": {
                                            "oneOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "PAGE"
                                                  },
                                                  "url": {
                                                    "type": "string"
                                                  },
                                                  "title": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ]
                                                  },
                                                  "rankGroup": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 1,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "rankAbsolute": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 1,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "missing": {
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "field": {
                                                          "type": "string"
                                                        },
                                                        "reason": {
                                                          "type": "string",
                                                          "enum": [
                                                            "UPSTREAM_FIELD_MISSING",
                                                            "UPSTREAM_FIELD_INVALID",
                                                            "DUPLICATE_UPSTREAM_ITEM",
                                                            "UPSTREAM_ITEM_MISSING"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "field",
                                                        "reason"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "url",
                                                  "title",
                                                  "rankGroup",
                                                  "rankAbsolute",
                                                  "missing"
                                                ],
                                                "additionalProperties": false
                                              },
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "IMAGE"
                                                  },
                                                  "pageUrl": {
                                                    "type": "string"
                                                  },
                                                  "imageUrl": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ]
                                                  },
                                                  "alt": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ]
                                                  },
                                                  "parentRankGroup": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 1,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "parentRankAbsolute": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 1,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "missing": {
                                                    "type": "array",
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "field": {
                                                          "type": "string"
                                                        },
                                                        "reason": {
                                                          "type": "string",
                                                          "enum": [
                                                            "UPSTREAM_FIELD_MISSING",
                                                            "UPSTREAM_FIELD_INVALID",
                                                            "DUPLICATE_UPSTREAM_ITEM",
                                                            "UPSTREAM_ITEM_MISSING"
                                                          ]
                                                        }
                                                      },
                                                      "required": [
                                                        "field",
                                                        "reason"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "pageUrl",
                                                  "imageUrl",
                                                  "alt",
                                                  "parentRankGroup",
                                                  "parentRankAbsolute",
                                                  "missing"
                                                ],
                                                "additionalProperties": false
                                              }
                                            ]
                                          }
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          }
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "marketScope",
                                        "languageFilter",
                                        "inputImageUrl",
                                        "imageUrl",
                                        "requestedLimit",
                                        "returnedCount",
                                        "truncated",
                                        "associatedKeyword",
                                        "sample",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-reverse-image-results",
        "x-nexscope-mcp-tool-name": "nexscope_seo_reverse_image_results",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-shopping-products/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Shopping Products",
        "description": "A bounded Google Shopping product search with observed product references and explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved.  Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoShoppingProducts",
        "externalDocs": {
          "description": "Shopping Products documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-shopping-products"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 40,
                    "default": 20
                  }
                },
                "required": [
                  "keyword"
                ],
                "additionalProperties": false
              },
              "example": {
                "keyword": "Reusable packaging"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_GOOGLE_SHOPPING_PRODUCTS"
                                            },
                                            "sampledAt": {
                                              "anyOf": [
                                                {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "retrievedAt": {
                                              "anyOf": [
                                                {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": "string",
                                                  "const": "en"
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string",
                                                    "maxLength": 256
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "keyword": {
                                          "type": "string",
                                          "maxLength": 200
                                        },
                                        "products": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "productRef": {
                                                "type": "string",
                                                "pattern": "^[0-9a-f]{64}$"
                                              },
                                              "title": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "description": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 8192
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "shoppingUrl": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 4096
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "price": {
                                                "anyOf": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "oldPrice": {
                                                "anyOf": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "currency": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "pattern": "^[A-Z]{3}$"
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "installmentMonths": {
                                                "anyOf": [
                                                  {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "seller": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "domain": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "rankGroup": {
                                                "anyOf": [
                                                  {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "rankAbsolute": {
                                                "anyOf": [
                                                  {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "detailEligible": {
                                                "type": "boolean"
                                              }
                                            },
                                            "required": [
                                              "productRef",
                                              "title",
                                              "description",
                                              "shoppingUrl",
                                              "price",
                                              "oldPrice",
                                              "currency",
                                              "installmentMonths",
                                              "seller",
                                              "domain",
                                              "rankGroup",
                                              "rankAbsolute",
                                              "detailEligible"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 40
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "keyword",
                                        "products"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-shopping-products",
        "x-nexscope-mcp-tool-name": "nexscope_seo_shopping_products",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-shopping-product-details/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Shopping Product Details",
        "description": "Source-bound Google Shopping product details with observed specifications and explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved.  Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoShoppingProductDetails",
        "externalDocs": {
          "description": "Shopping Product Details documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-shopping-product-details"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "productRef": {
                    "type": "string",
                    "pattern": "^[0-9a-f]{64}$"
                  }
                },
                "required": [
                  "task_id",
                  "productRef"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "22222222-2222-4222-8222-222222222222",
                "productRef": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_GOOGLE_SHOPPING_PRODUCT_INFO"
                                            },
                                            "sampledAt": {
                                              "anyOf": [
                                                {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "retrievedAt": {
                                              "anyOf": [
                                                {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": "string",
                                                  "const": "en"
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string",
                                                    "maxLength": 256
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "sourceCallId": {
                                          "type": "string",
                                          "format": "uuid"
                                        },
                                        "productRef": {
                                          "type": "string",
                                          "pattern": "^[0-9a-f]{64}$"
                                        },
                                        "details": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "title": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "description": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 8192
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "url": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 4096
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "images": {
                                                "type": "array",
                                                "items": {
                                                  "type": "string",
                                                  "maxLength": 4096
                                                },
                                                "maxItems": 20
                                              },
                                              "features": {
                                                "type": "array",
                                                "items": {
                                                  "type": "string",
                                                  "maxLength": 1024
                                                },
                                                "maxItems": 30
                                              },
                                              "specifications": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "blockName": {
                                                      "anyOf": [
                                                        {
                                                          "type": "string",
                                                          "maxLength": 1024
                                                        },
                                                        {
                                                          "type": "null"
                                                        }
                                                      ]
                                                    },
                                                    "name": {
                                                      "anyOf": [
                                                        {
                                                          "type": "string",
                                                          "maxLength": 1024
                                                        },
                                                        {
                                                          "type": "null"
                                                        }
                                                      ]
                                                    },
                                                    "value": {
                                                      "anyOf": [
                                                        {
                                                          "type": "string",
                                                          "maxLength": 8192
                                                        },
                                                        {
                                                          "type": "null"
                                                        }
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "blockName",
                                                    "name",
                                                    "value"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "maxItems": 50
                                              }
                                            },
                                            "required": [
                                              "title",
                                              "description",
                                              "url",
                                              "images",
                                              "features",
                                              "specifications"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "sourceCallId",
                                        "productRef",
                                        "details"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-shopping-product-details",
        "x-nexscope-mcp-tool-name": "nexscope_seo_shopping_product_details",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-shopping-seller-offers/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Shopping Seller Offers",
        "description": "Source-bound Google Shopping seller offers with observed prices and explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved.  Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoShoppingSellerOffers",
        "externalDocs": {
          "description": "Shopping Seller Offers documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-shopping-seller-offers"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "productRef": {
                    "type": "string",
                    "pattern": "^[0-9a-f]{64}$"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10,
                    "default": 10
                  }
                },
                "required": [
                  "task_id",
                  "productRef"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "22222222-2222-4222-8222-222222222222",
                "productRef": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_GOOGLE_SHOPPING_SELLERS"
                                            },
                                            "sampledAt": {
                                              "anyOf": [
                                                {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "retrievedAt": {
                                              "anyOf": [
                                                {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": "string",
                                                  "const": "en"
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string",
                                                    "maxLength": 256
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "sourceCallId": {
                                          "type": "string",
                                          "format": "uuid"
                                        },
                                        "productRef": {
                                          "type": "string",
                                          "pattern": "^[0-9a-f]{64}$"
                                        },
                                        "offers": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "sellerName": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "title": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "domain": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "url": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 4096
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "details": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 8192
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "basePrice": {
                                                "anyOf": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "tax": {
                                                "anyOf": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "shippingPrice": {
                                                "anyOf": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "totalPrice": {
                                                "anyOf": [
                                                  {
                                                    "type": "number",
                                                    "minimum": 0
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "currency": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "pattern": "^[A-Z]{3}$"
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "installmentMonths": {
                                                "anyOf": [
                                                  {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "paymentBreakdown": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 8192
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "rankGroup": {
                                                "anyOf": [
                                                  {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "rankAbsolute": {
                                                "anyOf": [
                                                  {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "sellerName",
                                              "title",
                                              "domain",
                                              "url",
                                              "details",
                                              "basePrice",
                                              "tax",
                                              "shippingPrice",
                                              "totalPrice",
                                              "currency",
                                              "installmentMonths",
                                              "paymentBreakdown",
                                              "rankGroup",
                                              "rankAbsolute"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "sourceCallId",
                                        "productRef",
                                        "offers"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-shopping-seller-offers",
        "x-nexscope-mcp-tool-name": "nexscope_seo_shopping_seller_offers",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/serp-screenshot-evidence/run": {
      "post": {
        "tags": [
          "Search Results & Rankings"
        ],
        "summary": "Serp Screenshot Evidence",
        "description": "Serp screenshot evidence with explicit observation scope and missing evidence. Uses a fixed bounded plan. Source and image facts retain their observation time; a screenshot does not prove current indexing or complete website coverage.",
        "operationId": "runSerpScreenshotEvidence",
        "externalDocs": {
          "description": "Serp Screenshot Evidence documentation",
          "url": "https://www.nexscope.ai/api-docs/serp-screenshot-evidence"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "maxLength": 64,
                    "minLength": 1
                  }
                },
                "required": [
                  "task_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "fixture-source"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "serp"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-SR-11"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "SERP_HTML_RENDER"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "sourceCallId": {
                                                "type": "string"
                                              },
                                              "engine": {
                                                "type": "string",
                                                "const": "GOOGLE"
                                              },
                                              "searchType": {
                                                "type": "string",
                                                "const": "ORGANIC"
                                              },
                                              "page": {
                                                "type": "integer",
                                                "const": 1
                                              },
                                              "device": {
                                                "type": "string",
                                                "const": "DESKTOP"
                                              },
                                              "sourceObservedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "renderedAt": {
                                                "type": "integer",
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "image": {
                                                "type": [
                                                  "object",
                                                  "null"
                                                ],
                                                "properties": {
                                                  "artifactId": {
                                                    "type": "string"
                                                  },
                                                  "mediaType": {
                                                    "type": "string",
                                                    "enum": [
                                                      "image/png",
                                                      "image/jpeg"
                                                    ]
                                                  },
                                                  "byteLength": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "sha256": {
                                                    "type": "string",
                                                    "pattern": "^[0-9a-f]{64}$"
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "height": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "expiresAt": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "downloadPath": {
                                                    "type": "string"
                                                  }
                                                },
                                                "required": [
                                                  "artifactId",
                                                  "mediaType",
                                                  "byteLength",
                                                  "sha256",
                                                  "width",
                                                  "height",
                                                  "expiresAt",
                                                  "downloadPath"
                                                ],
                                                "additionalProperties": false
                                              }
                                            },
                                            "required": [
                                              "sourceCallId",
                                              "engine",
                                              "searchType",
                                              "page",
                                              "device",
                                              "sourceObservedAt",
                                              "renderedAt",
                                              "image"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 1
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "serp-screenshot-evidence",
        "x-nexscope-mcp-tool-name": "nexscope_serp_screenshot_evidence",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-serp-competitors/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Organic Keyword Set Competitors",
        "description": "Organic Keyword Set Competitors. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoSerpCompetitors",
        "externalDocs": {
          "description": "Organic Keyword Set Competitors documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-serp-competitors"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  },
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    },
                    "minItems": 1,
                    "maxItems": 20
                  }
                },
                "required": [
                  "keywords"
                ],
                "additionalProperties": false
              },
              "example": {
                "limit": 2,
                "keywords": [
                  " Shoes ",
                  "shoes",
                  "boots"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 20
                                        },
                                        "seeds": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "normalizedSeeds": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "searchType": {
                                          "type": "string",
                                          "const": "organic"
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "rating_desc"
                                        },
                                        "trafficKind": {
                                          "type": "string",
                                          "const": "estimated"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "domain": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "averagePosition": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "medianPosition": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "rating": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "estimatedTraffic": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "keywordCount": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "domain",
                                              "averagePosition",
                                              "medianPosition",
                                              "rating",
                                              "estimatedTraffic",
                                              "keywordCount",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "requestedLimit",
                                        "returnedCount",
                                        "seeds",
                                        "normalizedSeeds",
                                        "searchType",
                                        "ordering",
                                        "trafficKind",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-serp-competitors",
        "x-nexscope-mcp-tool-name": "nexscope_seo_serp_competitors",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-domain-ranked-keywords/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Domain Organic Ranked Keywords",
        "description": "Domain Organic Ranked Keywords. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoDomainRankedKeywords",
        "externalDocs": {
          "description": "Domain Organic Ranked Keywords documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-domain-ranked-keywords"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  },
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": "example.com",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 20
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "searchType": {
                                          "type": "string",
                                          "const": "organic"
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "provider_default"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "searchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "cpcUsd": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                              },
                                              "url": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 1
                                              },
                                              "serpType": {
                                                "const": "organic",
                                                "type": "string"
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "searchVolume",
                                              "cpcUsd",
                                              "url",
                                              "rankGroup",
                                              "rankAbsolute",
                                              "serpType",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "requestedLimit",
                                        "returnedCount",
                                        "inputTarget",
                                        "target",
                                        "searchType",
                                        "ordering",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-domain-ranked-keywords",
        "x-nexscope-mcp-tool-name": "nexscope_seo_domain_ranked_keywords",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-domain-competitors/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Shared Organic Keyword Competitors",
        "description": "Shared Organic Keyword Competitors. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoDomainCompetitors",
        "externalDocs": {
          "description": "Shared Organic Keyword Competitors documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-domain-competitors"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  },
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": "example.com",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 20
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "searchType": {
                                          "type": "string",
                                          "const": "organic"
                                        },
                                        "maximumRankGroup": {
                                          "type": "integer",
                                          "const": 100
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "target_intersection_organic_count_desc"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "domain": {
                                                "type": "string",
                                                "minLength": 1
                                              },
                                              "averagePosition": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "sharedKeywordCount": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "domain",
                                              "averagePosition",
                                              "sharedKeywordCount",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "requestedLimit",
                                        "returnedCount",
                                        "inputTarget",
                                        "target",
                                        "searchType",
                                        "maximumRankGroup",
                                        "ordering",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-domain-competitors",
        "x-nexscope-mcp-tool-name": "nexscope_seo_domain_competitors",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-domain-keyword-intersection/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Domain Organic Keyword Intersection",
        "description": "Domain Organic Keyword Intersection. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoDomainKeywordIntersection",
        "externalDocs": {
          "description": "Domain Organic Keyword Intersection documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-domain-keyword-intersection"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target1": {
                    "type": "string"
                  },
                  "target2": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "INTERSECTION",
                      "FIRST_ONLY"
                    ],
                    "default": "INTERSECTION"
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target1",
                  "target2"
                ],
                "additionalProperties": false
              },
              "example": {
                "limit": 2,
                "mode": "FIRST_ONLY",
                "target2": "other.com",
                "target1": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputTarget1": {
                                          "type": "string"
                                        },
                                        "inputTarget2": {
                                          "type": "string"
                                        },
                                        "target1": {
                                          "type": "string"
                                        },
                                        "target2": {
                                          "type": "string"
                                        },
                                        "mode": {
                                          "type": "string",
                                          "enum": [
                                            "INTERSECTION",
                                            "FIRST_ONLY"
                                          ]
                                        },
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "searchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "first": {
                                                "type": "object",
                                                "properties": {
                                                  "type": {
                                                    "type": "string",
                                                    "const": "organic"
                                                  },
                                                  "url": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ]
                                                  },
                                                  "rankGroup": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 1
                                                  },
                                                  "rankAbsolute": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 1
                                                  }
                                                },
                                                "required": [
                                                  "type",
                                                  "url",
                                                  "rankGroup",
                                                  "rankAbsolute"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "second": {
                                                "anyOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "type": {
                                                        "type": "string",
                                                        "const": "organic"
                                                      },
                                                      "url": {
                                                        "type": [
                                                          "string",
                                                          "null"
                                                        ]
                                                      },
                                                      "rankGroup": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 1
                                                      },
                                                      "rankAbsolute": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 1
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "url",
                                                      "rankGroup",
                                                      "rankAbsolute"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "searchVolume",
                                              "first",
                                              "second",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "searchType": {
                                          "type": "string",
                                          "const": "organic"
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "search_volume_desc"
                                        }
                                      },
                                      "required": [
                                        "inputTarget1",
                                        "inputTarget2",
                                        "target1",
                                        "target2",
                                        "mode",
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "requestedLimit",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "searchType",
                                        "ordering"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-domain-keyword-intersection",
        "x-nexscope-mcp-tool-name": "nexscope_seo_domain_keyword_intersection",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-subdomain-performance/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Subdomain Organic Performance",
        "description": "Subdomain Organic Performance. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoSubdomainPerformance",
        "externalDocs": {
          "description": "Subdomain Organic Performance documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-subdomain-performance"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "target": {
                    "type": "string",
                    "maxLength": 254,
                    "minLength": 1
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": "example.com",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "subdomain": {
                                                "type": "string"
                                              },
                                              "organic": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "estimatedEquivalentAdsCostUsd": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                  },
                                                  "positions": {
                                                    "type": "object",
                                                    "properties": {
                                                      "p1": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p2to3": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p4to10": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p11to20": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p21to30": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p31to40": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p41to50": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p51to60": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p61to70": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p71to80": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p81to90": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p91to100": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "p1",
                                                      "p2to3",
                                                      "p4to10",
                                                      "p11to20",
                                                      "p21to30",
                                                      "p31to40",
                                                      "p41to50",
                                                      "p51to60",
                                                      "p61to70",
                                                      "p71to80",
                                                      "p81to90",
                                                      "p91to100"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount",
                                                  "estimatedEquivalentAdsCostUsd",
                                                  "positions"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "subdomain",
                                              "organic",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "searchType": {
                                          "type": "string",
                                          "const": "organic"
                                        },
                                        "trafficKind": {
                                          "type": "string",
                                          "const": "estimated"
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "organic_serp_count_desc"
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "requestedLimit",
                                        "inputTarget",
                                        "target",
                                        "searchType",
                                        "trafficKind",
                                        "ordering"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-subdomain-performance",
        "x-nexscope-mcp-tool-name": "nexscope_seo_subdomain_performance",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-top-pages/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Top Organic Ranking Pages",
        "description": "Top Organic Ranking Pages. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoTopPages",
        "externalDocs": {
          "description": "Top Organic Ranking Pages documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-top-pages"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "target": {
                    "type": "string",
                    "maxLength": 254,
                    "minLength": 1
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": "example.com",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string"
                                              },
                                              "organic": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "estimatedEquivalentAdsCostUsd": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                  },
                                                  "positions": {
                                                    "type": "object",
                                                    "properties": {
                                                      "p1": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p2to3": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p4to10": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p11to20": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p21to30": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p31to40": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p41to50": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p51to60": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p61to70": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p71to80": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p81to90": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p91to100": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "p1",
                                                      "p2to3",
                                                      "p4to10",
                                                      "p11to20",
                                                      "p21to30",
                                                      "p31to40",
                                                      "p41to50",
                                                      "p51to60",
                                                      "p61to70",
                                                      "p71to80",
                                                      "p81to90",
                                                      "p91to100"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount",
                                                  "estimatedEquivalentAdsCostUsd",
                                                  "positions"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "organic",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "searchType": {
                                          "type": "string",
                                          "const": "organic"
                                        },
                                        "trafficKind": {
                                          "type": "string",
                                          "const": "estimated"
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "organic_estimated_traffic_desc"
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "requestedLimit",
                                        "inputTarget",
                                        "target",
                                        "searchType",
                                        "trafficKind",
                                        "ordering"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-top-pages",
        "x-nexscope-mcp-tool-name": "nexscope_seo_top_pages",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-domain-rank-overview/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Domain Organic and Paid Rank Overview",
        "description": "Domain Organic and Paid Rank Overview. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoDomainRankOverview",
        "externalDocs": {
          "description": "Domain Organic and Paid Rank Overview documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-domain-rank-overview"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "target": {
                    "type": "string",
                    "maxLength": 254,
                    "minLength": 1
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "organic": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "estimatedEquivalentAdsCostUsd": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                  },
                                                  "positions": {
                                                    "type": "object",
                                                    "properties": {
                                                      "p1": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p2to3": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p4to10": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p11to20": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p21to30": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p31to40": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p41to50": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p51to60": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p61to70": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p71to80": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p81to90": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p91to100": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "p1",
                                                      "p2to3",
                                                      "p4to10",
                                                      "p11to20",
                                                      "p21to30",
                                                      "p31to40",
                                                      "p41to50",
                                                      "p51to60",
                                                      "p61to70",
                                                      "p71to80",
                                                      "p81to90",
                                                      "p91to100"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount",
                                                  "estimatedEquivalentAdsCostUsd",
                                                  "positions"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "paid": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "estimatedEquivalentAdsCostUsd": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                  },
                                                  "positions": {
                                                    "type": "object",
                                                    "properties": {
                                                      "p1": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p2to3": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p4to10": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p11to20": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p21to30": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p31to40": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p41to50": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p51to60": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p61to70": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p71to80": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p81to90": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p91to100": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "p1",
                                                      "p2to3",
                                                      "p4to10",
                                                      "p11to20",
                                                      "p21to30",
                                                      "p31to40",
                                                      "p41to50",
                                                      "p51to60",
                                                      "p61to70",
                                                      "p71to80",
                                                      "p81to90",
                                                      "p91to100"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount",
                                                  "estimatedEquivalentAdsCostUsd",
                                                  "positions"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "organic",
                                              "paid",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 1
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "searchTypes": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "trafficKind": {
                                          "type": "string",
                                          "const": "estimated"
                                        },
                                        "snapshotKind": {
                                          "type": "string",
                                          "const": "latest_database"
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "inputTarget",
                                        "target",
                                        "searchTypes",
                                        "trafficKind",
                                        "snapshotKind"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-domain-rank-overview",
        "x-nexscope-mcp-tool-name": "nexscope_seo_domain_rank_overview",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-domain-rank-history/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Domain Historical Ranking Distribution",
        "description": "Domain Historical Ranking Distribution. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoDomainRankHistory",
        "externalDocs": {
          "description": "Domain Historical Ranking Distribution documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-domain-rank-history"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "string"
                  },
                  "fromMonth": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}$"
                  },
                  "toMonth": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}$"
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  }
                },
                "required": [
                  "target",
                  "fromMonth",
                  "toMonth"
                ],
                "additionalProperties": false
              },
              "example": {
                "toMonth": "2026-03",
                "target": "Example.COM.",
                "fromMonth": "2026-01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "fromMonth": {
                                          "type": "string"
                                        },
                                        "toMonth": {
                                          "type": "string"
                                        },
                                        "resolvedDateFrom": {
                                          "type": "string"
                                        },
                                        "resolvedDateTo": {
                                          "type": "string"
                                        },
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "correlated": {
                                          "type": "boolean",
                                          "const": true
                                        },
                                        "trafficKind": {
                                          "type": "string",
                                          "const": "estimated"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "year": {
                                                "type": "integer",
                                                "minimum": 1
                                              },
                                              "month": {
                                                "type": "integer",
                                                "minimum": 1,
                                                "maximum": 12
                                              },
                                              "organic": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "estimatedEquivalentAdsCostUsd": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                  },
                                                  "positions": {
                                                    "type": "object",
                                                    "properties": {
                                                      "p1": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p2to3": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p4to10": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p11to20": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p21to30": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p31to40": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p41to50": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p51to60": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p61to70": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p71to80": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p81to90": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p91to100": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "p1",
                                                      "p2to3",
                                                      "p4to10",
                                                      "p11to20",
                                                      "p21to30",
                                                      "p31to40",
                                                      "p41to50",
                                                      "p51to60",
                                                      "p61to70",
                                                      "p71to80",
                                                      "p81to90",
                                                      "p91to100"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount",
                                                  "estimatedEquivalentAdsCostUsd",
                                                  "positions"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "paid": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "estimatedEquivalentAdsCostUsd": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                  },
                                                  "positions": {
                                                    "type": "object",
                                                    "properties": {
                                                      "p1": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p2to3": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p4to10": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p11to20": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p21to30": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p31to40": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p41to50": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p51to60": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p61to70": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p71to80": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p81to90": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p91to100": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "p1",
                                                      "p2to3",
                                                      "p4to10",
                                                      "p11to20",
                                                      "p21to30",
                                                      "p31to40",
                                                      "p41to50",
                                                      "p51to60",
                                                      "p61to70",
                                                      "p71to80",
                                                      "p81to90",
                                                      "p91to100"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount",
                                                  "estimatedEquivalentAdsCostUsd",
                                                  "positions"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "year",
                                              "month",
                                              "organic",
                                              "paid",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 12
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "inputTarget",
                                        "target",
                                        "fromMonth",
                                        "toMonth",
                                        "resolvedDateFrom",
                                        "resolvedDateTo",
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "correlated",
                                        "trafficKind",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-domain-rank-history",
        "x-nexscope-mcp-tool-name": "nexscope_seo_domain_rank_history",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-page-keyword-intersection/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Page Organic Keyword Intersection",
        "description": "Page Organic Keyword Intersection. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoPageKeywordIntersection",
        "externalDocs": {
          "description": "Page Organic Keyword Intersection documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-page-keyword-intersection"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "page1": {
                    "type": "string"
                  },
                  "page2": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "INTERSECTION",
                      "FIRST_ONLY"
                    ],
                    "default": "INTERSECTION"
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "page1",
                  "page2"
                ],
                "additionalProperties": false
              },
              "example": {
                "mode": "FIRST_ONLY",
                "page2": "https://other.com/b",
                "page1": "https://example.com/a",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputPage1": {
                                          "type": "string"
                                        },
                                        "inputPage2": {
                                          "type": "string"
                                        },
                                        "page1": {
                                          "type": "string"
                                        },
                                        "page2": {
                                          "type": "string"
                                        },
                                        "mode": {
                                          "type": "string",
                                          "enum": [
                                            "INTERSECTION",
                                            "FIRST_ONLY"
                                          ]
                                        },
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "searchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "first": {
                                                "type": "object",
                                                "properties": {
                                                  "type": {
                                                    "type": "string",
                                                    "const": "organic"
                                                  },
                                                  "url": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ]
                                                  },
                                                  "rankGroup": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 1
                                                  },
                                                  "rankAbsolute": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 1
                                                  }
                                                },
                                                "required": [
                                                  "type",
                                                  "url",
                                                  "rankGroup",
                                                  "rankAbsolute"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "second": {
                                                "anyOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "type": {
                                                        "type": "string",
                                                        "const": "organic"
                                                      },
                                                      "url": {
                                                        "type": [
                                                          "string",
                                                          "null"
                                                        ]
                                                      },
                                                      "rankGroup": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 1
                                                      },
                                                      "rankAbsolute": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 1
                                                      }
                                                    },
                                                    "required": [
                                                      "type",
                                                      "url",
                                                      "rankGroup",
                                                      "rankAbsolute"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "searchVolume",
                                              "first",
                                              "second",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "targetScope": {
                                          "type": "string",
                                          "const": "exact_url"
                                        },
                                        "searchType": {
                                          "type": "string",
                                          "const": "organic"
                                        }
                                      },
                                      "required": [
                                        "inputPage1",
                                        "inputPage2",
                                        "page1",
                                        "page2",
                                        "mode",
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "requestedLimit",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "targetScope",
                                        "searchType"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-page-keyword-intersection",
        "x-nexscope-mcp-tool-name": "nexscope_seo_page_keyword_intersection",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-target-traffic-estimates/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Multiple Target Organic and Paid Traffic Estimates",
        "description": "Multiple Target Organic and Paid Traffic Estimates. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoTargetTrafficEstimates",
        "externalDocs": {
          "description": "Multiple Target Organic and Paid Traffic Estimates documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-target-traffic-estimates"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "targets": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "DOMAIN",
                            "PAGE"
                          ]
                        },
                        "target": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind",
                        "target"
                      ],
                      "additionalProperties": false
                    },
                    "minItems": 1,
                    "maxItems": 20
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  }
                },
                "required": [
                  "targets"
                ],
                "additionalProperties": false
              },
              "example": {
                "targets": [
                  {
                    "kind": "DOMAIN",
                    "target": "example.com"
                  },
                  {
                    "kind": "PAGE",
                    "target": "https://example.com/a"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputTargets": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "DOMAIN",
                                                  "PAGE"
                                                ]
                                              },
                                              "target": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "target"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "normalizedTargets": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "DOMAIN",
                                                  "PAGE"
                                                ]
                                              },
                                              "target": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "target"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "trafficKind": {
                                          "type": "string",
                                          "const": "estimated"
                                        },
                                        "trafficMethod": {
                                          "type": "string",
                                          "const": "ctr_times_search_volume"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "DOMAIN",
                                                  "PAGE"
                                                ]
                                              },
                                              "target": {
                                                "type": "string"
                                              },
                                              "organic": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "paid": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "target",
                                              "organic",
                                              "paid",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "inputTargets",
                                        "normalizedTargets",
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "trafficKind",
                                        "trafficMethod",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-target-traffic-estimates",
        "x-nexscope-mcp-tool-name": "nexscope_seo_target_traffic_estimates",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-domain-traffic-history/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Historical Multi-Domain Traffic Comparison",
        "description": "Historical Multi-Domain Traffic Comparison. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoDomainTrafficHistory",
        "externalDocs": {
          "description": "Historical Multi-Domain Traffic Comparison documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-domain-traffic-history"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "targets": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "minItems": 2,
                    "maxItems": 20
                  },
                  "fromMonth": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}$"
                  },
                  "toMonth": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}$"
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  }
                },
                "required": [
                  "targets",
                  "fromMonth",
                  "toMonth"
                ],
                "additionalProperties": false
              },
              "example": {
                "toMonth": "2026-03",
                "targets": [
                  "example.com",
                  "other.com"
                ],
                "fromMonth": "2026-01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "inputTargets": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 2,
                                          "maxItems": 20
                                        },
                                        "normalizedTargets": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "minItems": 2,
                                          "maxItems": 20
                                        },
                                        "fromMonth": {
                                          "type": "string"
                                        },
                                        "toMonth": {
                                          "type": "string"
                                        },
                                        "resolvedDateFrom": {
                                          "type": "string"
                                        },
                                        "resolvedDateTo": {
                                          "type": "string"
                                        },
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "trafficKind": {
                                          "type": "string",
                                          "const": "estimated"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "year": {
                                                "type": "integer",
                                                "minimum": 1
                                              },
                                              "month": {
                                                "type": "integer",
                                                "minimum": 1,
                                                "maximum": 12
                                              },
                                              "targets": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "target": {
                                                      "type": "string"
                                                    },
                                                    "organic": {
                                                      "type": "object",
                                                      "properties": {
                                                        "estimatedMonthlyVisits": {
                                                          "type": [
                                                            "number",
                                                            "null"
                                                          ],
                                                          "minimum": 0
                                                        },
                                                        "serpCount": {
                                                          "type": [
                                                            "integer",
                                                            "null"
                                                          ],
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "estimatedMonthlyVisits",
                                                        "serpCount"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "paid": {
                                                      "type": "object",
                                                      "properties": {
                                                        "estimatedMonthlyVisits": {
                                                          "type": [
                                                            "number",
                                                            "null"
                                                          ],
                                                          "minimum": 0
                                                        },
                                                        "serpCount": {
                                                          "type": [
                                                            "integer",
                                                            "null"
                                                          ],
                                                          "minimum": 0
                                                        }
                                                      },
                                                      "required": [
                                                        "estimatedMonthlyVisits",
                                                        "serpCount"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "target",
                                                    "organic",
                                                    "paid",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 2,
                                                "maxItems": 20
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "year",
                                              "month",
                                              "targets",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 12
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "inputTargets",
                                        "normalizedTargets",
                                        "fromMonth",
                                        "toMonth",
                                        "resolvedDateFrom",
                                        "resolvedDateTo",
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "trafficKind",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-domain-traffic-history",
        "x-nexscope-mcp-tool-name": "nexscope_seo_domain_traffic_history",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-domain-categories/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Ranked Keyword Domain Categories",
        "description": "Ranked Keyword Domain Categories. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoDomainCategories",
        "externalDocs": {
          "description": "Ranked Keyword Domain Categories documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-domain-categories"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "target": {
                    "type": "string",
                    "maxLength": 254,
                    "minLength": 1
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": "example.com",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "categoryIds": {
                                                "type": "array",
                                                "items": {
                                                  "type": "integer",
                                                  "minimum": 1
                                                },
                                                "minItems": 1,
                                                "maxItems": 10000
                                              },
                                              "organic": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "estimatedEquivalentAdsCostUsd": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                  },
                                                  "positions": {
                                                    "type": "object",
                                                    "properties": {
                                                      "p1": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p2to3": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p4to10": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p11to20": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p21to30": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p31to40": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p41to50": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p51to60": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p61to70": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p71to80": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p81to90": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "p91to100": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "p1",
                                                      "p2to3",
                                                      "p4to10",
                                                      "p11to20",
                                                      "p21to30",
                                                      "p31to40",
                                                      "p41to50",
                                                      "p51to60",
                                                      "p61to70",
                                                      "p71to80",
                                                      "p81to90",
                                                      "p91to100"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount",
                                                  "estimatedEquivalentAdsCostUsd",
                                                  "positions"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "categoryIds",
                                              "organic",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "taxonomy": {
                                          "type": "string",
                                          "const": "google_product_service"
                                        },
                                        "classificationBasis": {
                                          "type": "string",
                                          "const": "ranked_keywords"
                                        },
                                        "includeSubcategories": {
                                          "type": "boolean",
                                          "const": false
                                        },
                                        "searchType": {
                                          "type": "string",
                                          "const": "organic"
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "requestedLimit",
                                        "inputTarget",
                                        "target",
                                        "taxonomy",
                                        "classificationBasis",
                                        "includeSubcategories",
                                        "searchType"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-domain-categories",
        "x-nexscope-mcp-tool-name": "nexscope_seo_domain_categories",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-category-domain-comparison/run": {
      "post": {
        "tags": [
          "Competitors & Traffic"
        ],
        "summary": "Category Related Domain Monthly Comparison",
        "description": "Category Related Domain Monthly Comparison. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoCategoryDomainComparison",
        "externalDocs": {
          "description": "Category Related Domain Monthly Comparison documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-category-domain-comparison"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "categoryIds": {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 2147483647
                    },
                    "minItems": 1,
                    "maxItems": 5
                  },
                  "firstMonth": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}$"
                  },
                  "secondMonth": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}$"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  }
                },
                "required": [
                  "categoryIds",
                  "firstMonth",
                  "secondMonth"
                ],
                "additionalProperties": false
              },
              "example": {
                "secondMonth": "2026-01",
                "limit": 2,
                "categoryIds": [
                  10001
                ],
                "firstMonth": "2026-03"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "categoryIds": {
                                          "type": "array",
                                          "items": {
                                            "type": "integer",
                                            "minimum": 1
                                          },
                                          "minItems": 1,
                                          "maxItems": 5
                                        },
                                        "normalizedCategoryIds": {
                                          "type": "array",
                                          "items": {
                                            "type": "integer",
                                            "minimum": 1
                                          },
                                          "minItems": 1,
                                          "maxItems": 5
                                        },
                                        "firstMonth": {
                                          "type": "string"
                                        },
                                        "secondMonth": {
                                          "type": "string"
                                        },
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "dataforseo_labs"
                                        },
                                        "engine": {
                                          "type": "string",
                                          "const": "google"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "taxonomy": {
                                          "type": "string",
                                          "const": "google_product_service"
                                        },
                                        "trafficKind": {
                                          "type": "string",
                                          "const": "estimated"
                                        },
                                        "comparisonDirection": {
                                          "type": "string",
                                          "const": "second_minus_first"
                                        },
                                        "ordering": {
                                          "type": "string",
                                          "const": "current_organic_etv_desc"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "domain": {
                                                "type": "string"
                                              },
                                              "mainDomain": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "categoryIds": {
                                                "type": "array",
                                                "items": {
                                                  "type": "integer",
                                                  "minimum": 1
                                                },
                                                "minItems": 0,
                                                "maxItems": 10000
                                              },
                                              "currentEstimatedMonthlyVisits": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "currentSerpCount": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "first": {
                                                "type": "object",
                                                "properties": {
                                                  "month": {
                                                    "type": "string"
                                                  },
                                                  "organic": {
                                                    "type": "object",
                                                    "properties": {
                                                      "estimatedMonthlyVisits": {
                                                        "type": [
                                                          "number",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "serpCount": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "estimatedEquivalentAdsCostUsd": {
                                                        "type": [
                                                          "string",
                                                          "null"
                                                        ],
                                                        "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                      },
                                                      "positions": {
                                                        "type": "object",
                                                        "properties": {
                                                          "p1": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p2to3": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p4to10": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p11to20": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p21to30": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p31to40": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p41to50": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p51to60": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p61to70": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p71to80": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p81to90": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p91to100": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "p1",
                                                          "p2to3",
                                                          "p4to10",
                                                          "p11to20",
                                                          "p21to30",
                                                          "p31to40",
                                                          "p41to50",
                                                          "p51to60",
                                                          "p61to70",
                                                          "p71to80",
                                                          "p81to90",
                                                          "p91to100"
                                                        ],
                                                        "additionalProperties": false
                                                      }
                                                    },
                                                    "required": [
                                                      "estimatedMonthlyVisits",
                                                      "serpCount",
                                                      "estimatedEquivalentAdsCostUsd",
                                                      "positions"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "month",
                                                  "organic"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "second": {
                                                "type": "object",
                                                "properties": {
                                                  "month": {
                                                    "type": "string"
                                                  },
                                                  "organic": {
                                                    "type": "object",
                                                    "properties": {
                                                      "estimatedMonthlyVisits": {
                                                        "type": [
                                                          "number",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "serpCount": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "estimatedEquivalentAdsCostUsd": {
                                                        "type": [
                                                          "string",
                                                          "null"
                                                        ],
                                                        "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$"
                                                      },
                                                      "positions": {
                                                        "type": "object",
                                                        "properties": {
                                                          "p1": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p2to3": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p4to10": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p11to20": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p21to30": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p31to40": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p41to50": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p51to60": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p61to70": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p71to80": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p81to90": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          },
                                                          "p91to100": {
                                                            "type": [
                                                              "integer",
                                                              "null"
                                                            ],
                                                            "minimum": 0
                                                          }
                                                        },
                                                        "required": [
                                                          "p1",
                                                          "p2to3",
                                                          "p4to10",
                                                          "p11to20",
                                                          "p21to30",
                                                          "p31to40",
                                                          "p41to50",
                                                          "p51to60",
                                                          "p61to70",
                                                          "p71to80",
                                                          "p81to90",
                                                          "p91to100"
                                                        ],
                                                        "additionalProperties": false
                                                      }
                                                    },
                                                    "required": [
                                                      "estimatedMonthlyVisits",
                                                      "serpCount",
                                                      "estimatedEquivalentAdsCostUsd",
                                                      "positions"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "month",
                                                  "organic"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "change": {
                                                "type": "object",
                                                "properties": {
                                                  "estimatedMonthlyVisits": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ]
                                                  },
                                                  "serpCount": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "estimatedMonthlyVisits",
                                                  "serpCount"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "domain",
                                              "mainDomain",
                                              "categoryIds",
                                              "currentEstimatedMonthlyVisits",
                                              "currentSerpCount",
                                              "first",
                                              "second",
                                              "change",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "categoryIds",
                                        "normalizedCategoryIds",
                                        "firstMonth",
                                        "secondMonth",
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "engine",
                                        "requestedLimit",
                                        "returnedCount",
                                        "taxonomy",
                                        "trafficKind",
                                        "comparisonDirection",
                                        "ordering",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-category-domain-comparison",
        "x-nexscope-mcp-tool-name": "nexscope_seo_category_domain_comparison",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/website-audit-summary/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Website Audit Summary",
        "description": "Website audit summary with explicit observation scope and missing evidence. Uses a fixed bounded plan. Source and image facts retain their observation time; a screenshot does not prove current indexing or complete website coverage.",
        "operationId": "runWebsiteAuditSummary",
        "externalDocs": {
          "description": "Website Audit Summary documentation",
          "url": "https://www.nexscope.ai/api-docs/website-audit-summary"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "string",
                    "maxLength": 253
                  },
                  "profile": {
                    "type": "string",
                    "enum": [
                      "BASE",
                      "ENRICHED"
                    ],
                    "default": "BASE"
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-02"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "target": {
                                                "type": "string"
                                              },
                                              "profile": {
                                                "type": "string",
                                                "enum": [
                                                  "BASE",
                                                  "ENRICHED"
                                                ]
                                              },
                                              "pagesCrawled": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "stopReason": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "crawlStartedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "crawlEndedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "onpageScore": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "internalLinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "externalLinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "duplicateTitles": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "duplicateDescriptions": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "duplicateContents": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "brokenLinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "brokenResources": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "nonIndexable": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "profile",
                                              "pagesCrawled",
                                              "stopReason",
                                              "crawlStartedAt",
                                              "crawlEndedAt",
                                              "onpageScore",
                                              "internalLinks",
                                              "externalLinks",
                                              "duplicateTitles",
                                              "duplicateDescriptions",
                                              "duplicateContents",
                                              "brokenLinks",
                                              "brokenResources",
                                              "nonIndexable"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 1
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "website-audit-summary",
        "x-nexscope-mcp-tool-name": "nexscope_website_audit_summary",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/website-page-checks/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Website Page Checks",
        "description": "Website Page Checks from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runWebsitePageChecks",
        "externalDocs": {
          "description": "Website Page Checks documentation",
          "url": "https://www.nexscope.ai/api-docs/website-page-checks"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "limit": {
                    "type": "integer",
                    "default": 10,
                    "minimum": 1,
                    "maximum": 10
                  }
                },
                "required": [
                  "task_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-03"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "maxLength": 2048
                                              },
                                              "statusCode": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 100,
                                                "maximum": 599
                                              },
                                              "title": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "maxLength": 4096
                                              },
                                              "description": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "maxLength": 4096
                                              },
                                              "canonical": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "maxLength": 2048
                                              },
                                              "sizeBytes": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "onpageScore": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "checks": {
                                                "type": "object",
                                                "properties": {
                                                  "isBroken": {
                                                    "type": [
                                                      "boolean",
                                                      "null"
                                                    ]
                                                  },
                                                  "is4xx": {
                                                    "type": [
                                                      "boolean",
                                                      "null"
                                                    ]
                                                  },
                                                  "is5xx": {
                                                    "type": [
                                                      "boolean",
                                                      "null"
                                                    ]
                                                  },
                                                  "isHttps": {
                                                    "type": [
                                                      "boolean",
                                                      "null"
                                                    ]
                                                  },
                                                  "noH1": {
                                                    "type": [
                                                      "boolean",
                                                      "null"
                                                    ]
                                                  },
                                                  "noDescription": {
                                                    "type": [
                                                      "boolean",
                                                      "null"
                                                    ]
                                                  },
                                                  "hasMicromarkup": {
                                                    "type": [
                                                      "boolean",
                                                      "null"
                                                    ]
                                                  },
                                                  "hasMicromarkupErrors": {
                                                    "type": [
                                                      "boolean",
                                                      "null"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "isBroken",
                                                  "is4xx",
                                                  "is5xx",
                                                  "isHttps",
                                                  "noH1",
                                                  "noDescription",
                                                  "hasMicromarkup",
                                                  "hasMicromarkupErrors"
                                                ],
                                                "additionalProperties": false
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "statusCode",
                                              "title",
                                              "description",
                                              "canonical",
                                              "sizeBytes",
                                              "onpageScore",
                                              "checks"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "website-page-checks",
        "x-nexscope-mcp-tool-name": "nexscope_website_page_checks",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/resource-affected-pages/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Resource Affected Pages",
        "description": "Resource Affected Pages from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runResourceAffectedPages",
        "externalDocs": {
          "description": "Resource Affected Pages documentation",
          "url": "https://www.nexscope.ai/api-docs/resource-affected-pages"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "resourceUrl": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "limit": {
                    "type": "integer",
                    "default": 10,
                    "minimum": 1,
                    "maximum": 10
                  }
                },
                "required": [
                  "task_id",
                  "resourceUrl"
                ],
                "additionalProperties": false
              },
              "example": {
                "resourceUrl": "https://cdn.example.com/a.js",
                "task_id": "source-call"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-04"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "resourceUrl": {
                                                "type": "string",
                                                "maxLength": 2048
                                              },
                                              "page": {
                                                "type": "object",
                                                "properties": {
                                                  "url": {
                                                    "type": "string",
                                                    "maxLength": 2048
                                                  },
                                                  "statusCode": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 100,
                                                    "maximum": 599
                                                  },
                                                  "title": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "maxLength": 4096
                                                  },
                                                  "description": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "maxLength": 4096
                                                  },
                                                  "canonical": {
                                                    "type": [
                                                      "string",
                                                      "null"
                                                    ],
                                                    "maxLength": 2048
                                                  },
                                                  "sizeBytes": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "onpageScore": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0,
                                                    "maximum": 100
                                                  },
                                                  "checks": {
                                                    "type": "object",
                                                    "properties": {
                                                      "isBroken": {
                                                        "type": [
                                                          "boolean",
                                                          "null"
                                                        ]
                                                      },
                                                      "is4xx": {
                                                        "type": [
                                                          "boolean",
                                                          "null"
                                                        ]
                                                      },
                                                      "is5xx": {
                                                        "type": [
                                                          "boolean",
                                                          "null"
                                                        ]
                                                      },
                                                      "isHttps": {
                                                        "type": [
                                                          "boolean",
                                                          "null"
                                                        ]
                                                      },
                                                      "noH1": {
                                                        "type": [
                                                          "boolean",
                                                          "null"
                                                        ]
                                                      },
                                                      "noDescription": {
                                                        "type": [
                                                          "boolean",
                                                          "null"
                                                        ]
                                                      },
                                                      "hasMicromarkup": {
                                                        "type": [
                                                          "boolean",
                                                          "null"
                                                        ]
                                                      },
                                                      "hasMicromarkupErrors": {
                                                        "type": [
                                                          "boolean",
                                                          "null"
                                                        ]
                                                      }
                                                    },
                                                    "required": [
                                                      "isBroken",
                                                      "is4xx",
                                                      "is5xx",
                                                      "isHttps",
                                                      "noH1",
                                                      "noDescription",
                                                      "hasMicromarkup",
                                                      "hasMicromarkupErrors"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "url",
                                                  "statusCode",
                                                  "title",
                                                  "description",
                                                  "canonical",
                                                  "sizeBytes",
                                                  "onpageScore",
                                                  "checks"
                                                ],
                                                "additionalProperties": false
                                              }
                                            },
                                            "required": [
                                              "resourceUrl",
                                              "page"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "resource-affected-pages",
        "x-nexscope-mcp-tool-name": "nexscope_resource_affected_pages",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/website-resource-status/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Website Resource Status",
        "description": "Website Resource Status from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runWebsiteResourceStatus",
        "externalDocs": {
          "description": "Website Resource Status documentation",
          "url": "https://www.nexscope.ai/api-docs/website-resource-status"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "pageUrl": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "limit": {
                    "type": "integer",
                    "default": 20,
                    "minimum": 1,
                    "maximum": 100
                  },
                  "offset": {
                    "type": "integer",
                    "default": 0,
                    "minimum": 0,
                    "maximum": 1000
                  }
                },
                "required": [
                  "task_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call",
                "pageUrl": "https://example.com/a"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-05"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "maxLength": 2048
                                              },
                                              "resourceType": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "enum": [
                                                  "SCRIPT",
                                                  "IMAGE",
                                                  "STYLESHEET",
                                                  "BROKEN",
                                                  "UNKNOWN",
                                                  null
                                                ]
                                              },
                                              "providerStatusCode": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 100,
                                                "maximum": 599
                                              },
                                              "sizeBytes": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "loadDurationMs": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "resourceType",
                                              "providerStatusCode",
                                              "sizeBytes",
                                              "loadDurationMs"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 100
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "website-resource-status",
        "x-nexscope-mcp-tool-name": "nexscope_website_resource_status",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/duplicate-page-tags/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Duplicate Page Tags",
        "description": "Duplicate Page Tags from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runDuplicatePageTags",
        "externalDocs": {
          "description": "Duplicate Page Tags documentation",
          "url": "https://www.nexscope.ai/api-docs/duplicate-page-tags"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "tagType": {
                    "type": "string",
                    "enum": [
                      "TITLE",
                      "DESCRIPTION"
                    ]
                  },
                  "limit": {
                    "type": "integer",
                    "default": 20,
                    "minimum": 1,
                    "maximum": 100
                  },
                  "offset": {
                    "type": "integer",
                    "default": 0,
                    "minimum": 0,
                    "maximum": 1000
                  }
                },
                "required": [
                  "task_id",
                  "tagType"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call",
                "tagType": "TITLE"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-06"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "tagType": {
                                                "type": "string",
                                                "enum": [
                                                  "TITLE",
                                                  "DESCRIPTION"
                                                ]
                                              },
                                              "value": {
                                                "type": "string",
                                                "maxLength": 4096
                                              },
                                              "totalCount": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "pages": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string",
                                                      "maxLength": 2048
                                                    },
                                                    "statusCode": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 100,
                                                      "maximum": 599
                                                    }
                                                  },
                                                  "required": [
                                                    "url",
                                                    "statusCode"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "maxItems": 10
                                              }
                                            },
                                            "required": [
                                              "tagType",
                                              "value",
                                              "totalCount",
                                              "pages"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 100
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "duplicate-page-tags",
        "x-nexscope-mcp-tool-name": "nexscope_duplicate_page_tags",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/duplicate-page-content/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Duplicate Page Content",
        "description": "Duplicate Page Content from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runDuplicatePageContent",
        "externalDocs": {
          "description": "Duplicate Page Content documentation",
          "url": "https://www.nexscope.ai/api-docs/duplicate-page-content"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "pageUrl": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "similarity": {
                    "type": "integer",
                    "default": 6,
                    "minimum": 0,
                    "maximum": 10
                  },
                  "limit": {
                    "type": "integer",
                    "default": 20,
                    "minimum": 1,
                    "maximum": 100
                  },
                  "offset": {
                    "type": "integer",
                    "default": 0,
                    "minimum": 0,
                    "maximum": 1000
                  }
                },
                "required": [
                  "task_id",
                  "pageUrl"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call",
                "pageUrl": "https://example.com/a"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-07"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "sourceUrl": {
                                                "type": "string",
                                                "maxLength": 2048
                                              },
                                              "url": {
                                                "type": "string",
                                                "maxLength": 2048
                                              },
                                              "statusCode": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 100,
                                                "maximum": 599
                                              },
                                              "similarity": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 10
                                              }
                                            },
                                            "required": [
                                              "sourceUrl",
                                              "url",
                                              "statusCode",
                                              "similarity"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 100
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "duplicate-page-content",
        "x-nexscope-mcp-tool-name": "nexscope_duplicate_page_content",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/website-links/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Website Links",
        "description": "Website Links from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runWebsiteLinks",
        "externalDocs": {
          "description": "Website Links documentation",
          "url": "https://www.nexscope.ai/api-docs/website-links"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "limit": {
                    "type": "integer",
                    "default": 20,
                    "minimum": 1,
                    "maximum": 100
                  },
                  "offset": {
                    "type": "integer",
                    "default": 0,
                    "minimum": 0,
                    "maximum": 1000
                  }
                },
                "required": [
                  "task_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-08"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "type": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "enum": [
                                                  "ANCHOR",
                                                  "IMAGE",
                                                  "CANONICAL",
                                                  "META",
                                                  "ALTERNATE",
                                                  "REDIRECT",
                                                  "UNKNOWN",
                                                  null
                                                ]
                                              },
                                              "fromUrl": {
                                                "type": "string",
                                                "maxLength": 2048
                                              },
                                              "toUrl": {
                                                "type": "string",
                                                "maxLength": 2048
                                              },
                                              "direction": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "enum": [
                                                  "INTERNAL",
                                                  "EXTERNAL",
                                                  "UNKNOWN",
                                                  null
                                                ]
                                              },
                                              "broken": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "dofollow": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "targetStatusCode": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 100,
                                                "maximum": 599
                                              },
                                              "text": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "maxLength": 4096
                                              }
                                            },
                                            "required": [
                                              "type",
                                              "fromUrl",
                                              "toUrl",
                                              "direction",
                                              "broken",
                                              "dofollow",
                                              "targetStatusCode",
                                              "text"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 100
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "website-links",
        "x-nexscope-mcp-tool-name": "nexscope_website_links",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/website-redirect-chains/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Website Redirect Chains",
        "description": "Website Redirect Chains from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runWebsiteRedirectChains",
        "externalDocs": {
          "description": "Website Redirect Chains documentation",
          "url": "https://www.nexscope.ai/api-docs/website-redirect-chains"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "pageUrl": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "limit": {
                    "type": "integer",
                    "default": 20,
                    "minimum": 1,
                    "maximum": 100
                  },
                  "offset": {
                    "type": "integer",
                    "default": 0,
                    "minimum": 0,
                    "maximum": 1000
                  }
                },
                "required": [
                  "task_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call",
                "pageUrl": "https://example.com/a"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-09"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "loop": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "hops": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "fromUrl": {
                                                      "type": "string",
                                                      "maxLength": 2048
                                                    },
                                                    "toUrl": {
                                                      "type": "string",
                                                      "maxLength": 2048
                                                    }
                                                  },
                                                  "required": [
                                                    "fromUrl",
                                                    "toUrl"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "maxItems": 20
                                              }
                                            },
                                            "required": [
                                              "loop",
                                              "hops"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 100
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "website-redirect-chains",
        "x-nexscope-mcp-tool-name": "nexscope_website_redirect_chains",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/non-indexable-pages/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Non Indexable Pages",
        "description": "Non Indexable Pages from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runNonIndexablePages",
        "externalDocs": {
          "description": "Non Indexable Pages documentation",
          "url": "https://www.nexscope.ai/api-docs/non-indexable-pages"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "limit": {
                    "type": "integer",
                    "default": 20,
                    "minimum": 1,
                    "maximum": 100
                  },
                  "offset": {
                    "type": "integer",
                    "default": 0,
                    "minimum": 0,
                    "maximum": 1000
                  }
                },
                "required": [
                  "task_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-10"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string",
                                                "maxLength": 2048
                                              },
                                              "reason": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "enum": [
                                                  "ROBOTS_TXT",
                                                  "META_TAG",
                                                  "HTTP_HEADER",
                                                  "ATTRIBUTE",
                                                  "TOO_MANY_REDIRECTS",
                                                  "UNKNOWN",
                                                  null
                                                ]
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 100
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "non-indexable-pages",
        "x-nexscope-mcp-tool-name": "nexscope_non_indexable_pages",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/page-loading-waterfall/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Page Loading Waterfall",
        "description": "Page Loading Waterfall from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runPageLoadingWaterfall",
        "externalDocs": {
          "description": "Page Loading Waterfall documentation",
          "url": "https://www.nexscope.ai/api-docs/page-loading-waterfall"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "pageUrl": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  }
                },
                "required": [
                  "task_id",
                  "pageUrl"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call",
                "pageUrl": "https://example.com/a"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-11"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "pageUrl": {
                                                "type": "string",
                                                "maxLength": 2048
                                              },
                                              "interactiveMs": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "domCompleteMs": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "connectionMs": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "secureConnectionMs": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "waitMs": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "durationMs": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "resources": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string",
                                                      "maxLength": 2048
                                                    },
                                                    "type": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "initiator": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ],
                                                      "maxLength": 4096
                                                    },
                                                    "startMs": {
                                                      "type": [
                                                        "number",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "endMs": {
                                                      "type": [
                                                        "number",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "durationMs": {
                                                      "type": [
                                                        "number",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "renderBlocking": {
                                                      "type": [
                                                        "boolean",
                                                        "null"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "url",
                                                    "type",
                                                    "initiator",
                                                    "startMs",
                                                    "endMs",
                                                    "durationMs",
                                                    "renderBlocking"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "maxItems": 200
                                              }
                                            },
                                            "required": [
                                              "pageUrl",
                                              "interactiveMs",
                                              "domCompleteMs",
                                              "connectionMs",
                                              "secureConnectionMs",
                                              "waitMs",
                                              "durationMs",
                                              "resources"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 1
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "page-loading-waterfall",
        "x-nexscope-mcp-tool-name": "nexscope_page_loading_waterfall",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/page-keyword-density/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Page Keyword Density",
        "description": "Page Keyword Density from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runPageKeywordDensity",
        "externalDocs": {
          "description": "Page Keyword Density documentation",
          "url": "https://www.nexscope.ai/api-docs/page-keyword-density"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "pageUrl": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  "keywordLength": {
                    "type": "integer",
                    "default": 1,
                    "minimum": 1,
                    "maximum": 5
                  },
                  "limit": {
                    "type": "integer",
                    "default": 20,
                    "minimum": 1,
                    "maximum": 100
                  }
                },
                "required": [
                  "task_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call",
                "pageUrl": "https://example.com/a"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-12"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string",
                                                "maxLength": 4096
                                              },
                                              "frequency": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "densityRatio": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "frequency",
                                              "densityRatio"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 100
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "page-keyword-density",
        "x-nexscope-mcp-tool-name": "nexscope_page_keyword_density",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/page-structured-data/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Page Structured Data",
        "description": "Page Structured Data from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.",
        "operationId": "runPageStructuredData",
        "externalDocs": {
          "description": "Page Structured Data documentation",
          "url": "https://www.nexscope.ai/api-docs/page-structured-data"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "task_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "pageUrl": {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  }
                },
                "required": [
                  "task_id",
                  "pageUrl"
                ],
                "additionalProperties": false
              },
              "example": {
                "task_id": "source-call",
                "pageUrl": "https://example.com/a"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-13"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "CRAWL_SAMPLE"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "testSummary": {
                                                "type": "object",
                                                "properties": {
                                                  "fatal": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "error": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "warning": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "info": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "fatal",
                                                  "error",
                                                  "warning",
                                                  "info"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "documents": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "format": {
                                                      "type": "string",
                                                      "const": "JSON_LD"
                                                    },
                                                    "types": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "string"
                                                      },
                                                      "maxItems": 100
                                                    },
                                                    "fields": {
                                                      "type": "array",
                                                      "items": {
                                                        "$ref": "#/$defs/MarkupField"
                                                      },
                                                      "maxItems": 200
                                                    }
                                                  },
                                                  "required": [
                                                    "format",
                                                    "types",
                                                    "fields"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "maxItems": 200
                                              }
                                            },
                                            "required": [
                                              "testSummary",
                                              "documents"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 1
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "$defs": {
                    "MarkupField": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "types": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "maxItems": 100
                        },
                        "values": {
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "STRING"
                                  },
                                  "value": {
                                    "type": "string",
                                    "maxLength": 4096
                                  }
                                },
                                "required": [
                                  "kind",
                                  "value"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "NUMBER"
                                  },
                                  "value": {
                                    "type": "number"
                                  }
                                },
                                "required": [
                                  "kind",
                                  "value"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "BOOLEAN"
                                  },
                                  "value": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "kind",
                                  "value"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "NULL"
                                  },
                                  "value": {
                                    "type": "null"
                                  }
                                },
                                "required": [
                                  "kind",
                                  "value"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          },
                          "maxItems": 100
                        },
                        "children": {
                          "type": "array",
                          "items": {
                            "$ref": "#/$defs/MarkupField"
                          },
                          "maxItems": 200
                        },
                        "issues": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "level": {
                                "type": "string",
                                "enum": [
                                  "fatal",
                                  "error",
                                  "warning",
                                  "info"
                                ]
                              },
                              "message": {
                                "type": "string",
                                "maxLength": 4096
                              }
                            },
                            "required": [
                              "level",
                              "message"
                            ],
                            "additionalProperties": false
                          },
                          "maxItems": 100
                        }
                      },
                      "required": [
                        "name",
                        "types",
                        "values",
                        "children",
                        "issues"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "page-structured-data",
        "x-nexscope-mcp-tool-name": "nexscope_page_structured_data",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/page-screenshot/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Page Screenshot",
        "description": "Page screenshot with explicit observation scope and missing evidence. Uses a fixed bounded plan. Source and image facts retain their observation time; a screenshot does not prove current indexing or complete website coverage.",
        "operationId": "runPageScreenshot",
        "externalDocs": {
          "description": "Page Screenshot documentation",
          "url": "https://www.nexscope.ai/api-docs/page-screenshot"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "device": {
                    "type": "string",
                    "enum": [
                      "DESKTOP",
                      "MOBILE"
                    ],
                    "default": "DESKTOP"
                  }
                },
                "required": [
                  "url"
                ],
                "additionalProperties": false
              },
              "example": {
                "url": "https://example.com/a"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-14"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "LIVE_PAGE_RENDER"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string"
                                              },
                                              "device": {
                                                "type": "string",
                                                "enum": [
                                                  "DESKTOP",
                                                  "MOBILE"
                                                ]
                                              },
                                              "capturedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 9007199254740991
                                              },
                                              "image": {
                                                "type": [
                                                  "object",
                                                  "null"
                                                ],
                                                "properties": {
                                                  "artifactId": {
                                                    "type": "string"
                                                  },
                                                  "mediaType": {
                                                    "type": "string",
                                                    "enum": [
                                                      "image/png",
                                                      "image/jpeg"
                                                    ]
                                                  },
                                                  "byteLength": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "sha256": {
                                                    "type": "string",
                                                    "pattern": "^[0-9a-f]{64}$"
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "height": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "expiresAt": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "downloadPath": {
                                                    "type": "string"
                                                  }
                                                },
                                                "required": [
                                                  "artifactId",
                                                  "mediaType",
                                                  "byteLength",
                                                  "sha256",
                                                  "width",
                                                  "height",
                                                  "expiresAt",
                                                  "downloadPath"
                                                ],
                                                "additionalProperties": false
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "device",
                                              "capturedAt",
                                              "image"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 1
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string"
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 10000
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 1000
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "page-screenshot",
        "x-nexscope-mcp-tool-name": "nexscope_page_screenshot",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/page-lighthouse/run": {
      "post": {
        "tags": [
          "Pages & Websites"
        ],
        "summary": "Page Lighthouse Laboratory Evidence",
        "description": "Page Lighthouse Laboratory Evidence. Bounded Lighthouse laboratory facts with explicit missing evidence. One submit and at most six fixed reads. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runPageLighthouse",
        "externalDocs": {
          "description": "Page Lighthouse Laboratory Evidence documentation",
          "url": "https://www.nexscope.ai/api-docs/page-lighthouse"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "maxLength": 2048
                  },
                  "device": {
                    "type": "string",
                    "enum": [
                      "DESKTOP",
                      "MOBILE"
                    ],
                    "default": "DESKTOP"
                  }
                },
                "required": [
                  "url"
                ],
                "additionalProperties": false
              },
              "example": {
                "url": "https://example.com/"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "provider": {
                                              "type": "string",
                                              "const": "DATAFORSEO"
                                            },
                                            "product": {
                                              "type": "string",
                                              "const": "on_page"
                                            },
                                            "candidateId": {
                                              "type": "string",
                                              "const": "MD-PW-15"
                                            },
                                            "sourceCallId": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourceSchemaVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "sourcePlanVersion": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "collectedAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "queriedAt": {
                                              "type": "integer",
                                              "minimum": 0
                                            },
                                            "observationKind": {
                                              "type": "string",
                                              "const": "LAB_RUN"
                                            }
                                          },
                                          "required": [
                                            "provider",
                                            "product",
                                            "candidateId",
                                            "sourceCallId",
                                            "sourceSchemaVersion",
                                            "sourcePlanVersion",
                                            "collectedAt",
                                            "queriedAt",
                                            "observationKind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "coverage": {
                                          "type": "object",
                                          "properties": {
                                            "sampled": {
                                              "type": "boolean",
                                              "const": true
                                            },
                                            "maxCrawlPages": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "pagesCrawled": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "stopReason": {
                                              "type": [
                                                "string",
                                                "null"
                                              ]
                                            },
                                            "providerTotal": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "returnedCount": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 1
                                            },
                                            "offset": {
                                              "type": "integer",
                                              "const": 0
                                            },
                                            "limit": {
                                              "type": "integer",
                                              "const": 1
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "invalidItemCount": {
                                              "type": "integer",
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "sampled",
                                            "maxCrawlPages",
                                            "pagesCrawled",
                                            "stopReason",
                                            "providerTotal",
                                            "returnedCount",
                                            "offset",
                                            "limit",
                                            "truncated",
                                            "invalidItemCount"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "requestedUrl": {
                                                "type": "string"
                                              },
                                              "finalUrl": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "lighthouseVersion": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "fetchTime": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "device": {
                                                "type": "string",
                                                "enum": [
                                                  "DESKTOP",
                                                  "MOBILE"
                                                ]
                                              },
                                              "categories": {
                                                "type": "object",
                                                "properties": {
                                                  "performance": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  },
                                                  "accessibility": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  },
                                                  "bestPractices": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  },
                                                  "seo": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0,
                                                    "maximum": 1
                                                  }
                                                },
                                                "required": [
                                                  "performance",
                                                  "accessibility",
                                                  "bestPractices",
                                                  "seo"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "metrics": {
                                                "type": "object",
                                                "properties": {
                                                  "firstContentfulPaintMs": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "largestContentfulPaintMs": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "totalBlockingTimeMs": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "cumulativeLayoutShift": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "speedIndexMs": {
                                                    "type": [
                                                      "number",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "firstContentfulPaintMs",
                                                  "largestContentfulPaintMs",
                                                  "totalBlockingTimeMs",
                                                  "cumulativeLayoutShift",
                                                  "speedIndexMs"
                                                ],
                                                "additionalProperties": false
                                              }
                                            },
                                            "required": [
                                              "requestedUrl",
                                              "finalUrl",
                                              "lighthouseVersion",
                                              "fetchTime",
                                              "device",
                                              "categories",
                                              "metrics"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 1
                                        },
                                        "missingFields": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          }
                                        },
                                        "warnings": {
                                          "type": "array",
                                          "items": {
                                            "type": "string"
                                          }
                                        }
                                      },
                                      "required": [
                                        "source",
                                        "coverage",
                                        "items",
                                        "missingFields",
                                        "warnings"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "page-lighthouse",
        "x-nexscope-mcp-tool-name": "nexscope_page_lighthouse",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-model-answer-observation/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-model-answer-observation",
        "description": "Single fixed model answer observation with no web search and at most512 output tokens. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.",
        "operationId": "runSeoModelAnswerObservation",
        "externalDocs": {
          "description": "seo-model-answer-observation documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-model-answer-observation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "prompt": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500,
                    "description": "Trim/NFC; Unicode code point limit500; newline and tab allowed. No tools/history/web options."
                  }
                },
                "required": [
                  "prompt"
                ],
                "additionalProperties": false
              },
              "example": {
                "prompt": " Explain\nshoes + 50% "
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_MODEL_API"
                                            },
                                            "sampledAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "retrievedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "market": {
                                              "type": "null"
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string"
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "prompt": {
                                          "type": "string"
                                        },
                                        "requestedModel": {
                                          "type": "string",
                                          "const": "gpt-4.1-mini-2025-04-14"
                                        },
                                        "observedModel": {
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "answerText": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "maxLength": 65536
                                        },
                                        "inputTokens": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "outputTokens": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "reasoningTokens": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "webSearch": {
                                          "type": [
                                            "boolean",
                                            "null"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "prompt",
                                        "requestedModel",
                                        "observedModel",
                                        "answerText",
                                        "inputTokens",
                                        "outputTokens",
                                        "reasoningTokens",
                                        "webSearch"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-model-answer-observation",
        "x-nexscope-mcp-tool-name": "nexscope_seo_model_answer_observation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-search-citation-sample/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "AI Search Citation Sample",
        "description": "AI Search Citation Sample. A bounded consumer ChatGPT answer and citation observation with explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.",
        "operationId": "runSeoAiSearchCitationSample",
        "externalDocs": {
          "description": "AI Search Citation Sample documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-search-citation-sample"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "prompt": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000
                  }
                },
                "required": [
                  "prompt"
                ],
                "additionalProperties": false
              },
              "example": {
                "prompt": "Compare reusable packaging"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_CHATGPT_INTERFACE"
                                            },
                                            "sampledAt": {
                                              "anyOf": [
                                                {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "retrievedAt": {
                                              "anyOf": [
                                                {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ]
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": "string",
                                                  "const": "en"
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string"
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "prompt": {
                                          "type": "string",
                                          "maxLength": 2000
                                        },
                                        "model": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "maxLength": 1024
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "answerMarkdown": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "maxLength": 65536
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "checkUrl": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "maxLength": 4096
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        },
                                        "citations": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "title": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "snippet": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 8192
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "domain": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "url": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 4096
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "sourceName": {
                                                "anyOf": [
                                                  {
                                                    "type": "string",
                                                    "maxLength": 1024
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              },
                                              "publishedAt": {
                                                "anyOf": [
                                                  {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ]
                                              }
                                            },
                                            "required": [
                                              "title",
                                              "snippet",
                                              "domain",
                                              "url",
                                              "sourceName",
                                              "publishedAt"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "maxItems": 50
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "prompt",
                                        "model",
                                        "answerMarkdown",
                                        "checkUrl",
                                        "citations"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-search-citation-sample",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_search_citation_sample",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-mention-records/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-mention-records",
        "description": "Historical answer records with separate cited sources, search references and brand entities. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiMentionRecords",
        "externalDocs": {
          "description": "seo-ai-mention-records documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-mention-records"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "DOMAIN"
                            },
                            "domain": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Normalized ASCII hostname at most63 characters."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "includeSubdomains": {
                              "type": "boolean",
                              "default": false
                            }
                          },
                          "required": [
                            "kind",
                            "domain"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "KEYWORD"
                            },
                            "keyword": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "matchType": {
                              "type": "string",
                              "enum": [
                                "word_match",
                                "partial_match"
                              ],
                              "default": "word_match"
                            }
                          },
                          "required": [
                            "kind",
                            "keyword"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "google",
                      "chat_gpt"
                    ],
                    "default": "google"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": [
                  {
                    "kind": "DOMAIN",
                    "domain": " Example.COM "
                  }
                ],
                "platform": "chat_gpt"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "normalizedTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "google",
                                                "chat_gpt"
                                              ]
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "ordering": {
                                              "type": "string",
                                              "const": "ai_search_volume_desc"
                                            },
                                            "unsupportedDimensions": {
                                              "type": "array",
                                              "items": {
                                                "type": "string",
                                                "enum": [
                                                  "searchResults",
                                                  "brands"
                                                ]
                                              },
                                              "minItems": 0,
                                              "maxItems": 2
                                            }
                                          },
                                          "required": [
                                            "inputTargets",
                                            "normalizedTargets",
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "ordering",
                                            "unsupportedDimensions"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "totalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "question": {
                                                "type": "string"
                                              },
                                              "answerMarkdown": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "modelName": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "aiSearchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "firstRecordedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lastRecordedAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "webSearchBased": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "sources": {
                                                "type": [
                                                  "array",
                                                  "null"
                                                ],
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string"
                                                    },
                                                    "domain": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "title": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "rank": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "publishedAt": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "url",
                                                    "domain",
                                                    "title",
                                                    "rank",
                                                    "publishedAt"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 20
                                              },
                                              "searchResults": {
                                                "type": [
                                                  "array",
                                                  "null"
                                                ],
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": "string"
                                                    },
                                                    "domain": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "title": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "rank": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "publishedAt": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "url",
                                                    "domain",
                                                    "title",
                                                    "rank",
                                                    "publishedAt"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 20
                                              },
                                              "brands": {
                                                "type": [
                                                  "array",
                                                  "null"
                                                ],
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "title": {
                                                      "type": "string"
                                                    },
                                                    "category": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "rank": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "title",
                                                    "category",
                                                    "rank"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 20
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "question",
                                              "answerMarkdown",
                                              "modelName",
                                              "aiSearchVolume",
                                              "firstRecordedAt",
                                              "lastRecordedAt",
                                              "webSearchBased",
                                              "sources",
                                              "searchResults",
                                              "brands",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "totalCount",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-mention-records",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_mention_records",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-target-metrics/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-target-metrics",
        "description": "AI target metrics from provider database aggregates. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiTargetMetrics",
        "externalDocs": {
          "description": "seo-ai-target-metrics documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-target-metrics"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "DOMAIN"
                            },
                            "domain": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Normalized ASCII hostname at most63 characters."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "includeSubdomains": {
                              "type": "boolean",
                              "default": false
                            }
                          },
                          "required": [
                            "kind",
                            "domain"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "KEYWORD"
                            },
                            "keyword": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "matchType": {
                              "type": "string",
                              "enum": [
                                "word_match",
                                "partial_match"
                              ],
                              "default": "word_match"
                            }
                          },
                          "required": [
                            "kind",
                            "keyword"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "google",
                      "chat_gpt"
                    ],
                    "default": "google"
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": [
                  {
                    "kind": "DOMAIN",
                    "domain": " Example.COM "
                  },
                  {
                    "kind": "KEYWORD",
                    "keyword": " Shoes "
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "normalizedTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "google",
                                                "chat_gpt"
                                              ],
                                              "default": "google"
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "unsupportedDimensions": {
                                              "type": "array",
                                              "items": {
                                                "type": "string",
                                                "enum": [
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ]
                                              },
                                              "minItems": 0,
                                              "maxItems": 3
                                            }
                                          },
                                          "required": [
                                            "inputTargets",
                                            "normalizedTargets",
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "unsupportedDimensions"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "metrics": {
                                          "type": "object",
                                          "properties": {
                                            "total": {
                                              "type": "object",
                                              "properties": {
                                                "mentions": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                },
                                                "aiSearchVolume": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "mentions",
                                                "aiSearchVolume"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "sourceDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "searchResultDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brands": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brandCategories": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            }
                                          },
                                          "required": [
                                            "total",
                                            "sourceDomains",
                                            "searchResultDomains",
                                            "brands",
                                            "brandCategories"
                                          ],
                                          "additionalProperties": false
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "missing",
                                        "metrics"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-target-metrics",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_target_metrics",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-target-comparison/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-target-comparison",
        "description": "Independent target group metrics and provider union aggregate without summing overlapping groups. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiTargetComparison",
        "externalDocs": {
          "description": "seo-ai-target-comparison documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-target-comparison"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "google",
                      "chat_gpt"
                    ],
                    "default": "google"
                  },
                  "groups": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "key": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "target": {
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "DOMAIN"
                                  },
                                  "domain": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Normalized ASCII hostname at most63 characters."
                                  },
                                  "searchFilter": {
                                    "type": "string",
                                    "enum": [
                                      "include",
                                      "exclude"
                                    ],
                                    "default": "include"
                                  },
                                  "includeSubdomains": {
                                    "type": "boolean",
                                    "default": false
                                  }
                                },
                                "required": [
                                  "kind",
                                  "domain"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "KEYWORD"
                                  },
                                  "keyword": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                  },
                                  "searchFilter": {
                                    "type": "string",
                                    "enum": [
                                      "include",
                                      "exclude"
                                    ],
                                    "default": "include"
                                  },
                                  "matchType": {
                                    "type": "string",
                                    "enum": [
                                      "word_match",
                                      "partial_match"
                                    ],
                                    "default": "word_match"
                                  }
                                },
                                "required": [
                                  "kind",
                                  "keyword"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          },
                          "minItems": 1,
                          "maxItems": 10
                        }
                      },
                      "required": [
                        "key",
                        "target"
                      ],
                      "additionalProperties": false
                    },
                    "minItems": 2,
                    "maxItems": 10
                  }
                },
                "required": [
                  "groups"
                ],
                "additionalProperties": false
              },
              "example": {
                "groups": [
                  {
                    "key": " A ",
                    "target": [
                      {
                        "kind": "DOMAIN",
                        "domain": " Example.COM "
                      }
                    ]
                  },
                  {
                    "key": "B",
                    "target": [
                      {
                        "kind": "KEYWORD",
                        "keyword": " Shoes "
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "google",
                                                "chat_gpt"
                                              ],
                                              "default": "google"
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "unsupportedDimensions": {
                                              "type": "array",
                                              "items": {
                                                "type": "string",
                                                "enum": [
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ]
                                              },
                                              "minItems": 0,
                                              "maxItems": 3
                                            },
                                            "groups": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "key": {
                                                    "type": "string"
                                                  },
                                                  "inputTargets": {
                                                    "type": "array",
                                                    "items": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "DOMAIN"
                                                            },
                                                            "domain": {
                                                              "type": "string",
                                                              "minLength": 1,
                                                              "description": "Normalized ASCII hostname at most63 characters."
                                                            },
                                                            "searchFilter": {
                                                              "type": "string",
                                                              "enum": [
                                                                "include",
                                                                "exclude"
                                                              ],
                                                              "default": "include"
                                                            },
                                                            "includeSubdomains": {
                                                              "type": "boolean",
                                                              "default": false
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "domain",
                                                            "searchFilter",
                                                            "includeSubdomains"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "KEYWORD"
                                                            },
                                                            "keyword": {
                                                              "type": "string",
                                                              "minLength": 1,
                                                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                            },
                                                            "searchFilter": {
                                                              "type": "string",
                                                              "enum": [
                                                                "include",
                                                                "exclude"
                                                              ],
                                                              "default": "include"
                                                            },
                                                            "matchType": {
                                                              "type": "string",
                                                              "enum": [
                                                                "word_match",
                                                                "partial_match"
                                                              ],
                                                              "default": "word_match"
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "keyword",
                                                            "searchFilter",
                                                            "matchType"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      ]
                                                    },
                                                    "minItems": 1,
                                                    "maxItems": 10
                                                  },
                                                  "normalizedTargets": {
                                                    "type": "array",
                                                    "items": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "DOMAIN"
                                                            },
                                                            "domain": {
                                                              "type": "string",
                                                              "minLength": 1,
                                                              "description": "Normalized ASCII hostname at most63 characters."
                                                            },
                                                            "searchFilter": {
                                                              "type": "string",
                                                              "enum": [
                                                                "include",
                                                                "exclude"
                                                              ],
                                                              "default": "include"
                                                            },
                                                            "includeSubdomains": {
                                                              "type": "boolean",
                                                              "default": false
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "domain",
                                                            "searchFilter",
                                                            "includeSubdomains"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "KEYWORD"
                                                            },
                                                            "keyword": {
                                                              "type": "string",
                                                              "minLength": 1,
                                                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                            },
                                                            "searchFilter": {
                                                              "type": "string",
                                                              "enum": [
                                                                "include",
                                                                "exclude"
                                                              ],
                                                              "default": "include"
                                                            },
                                                            "matchType": {
                                                              "type": "string",
                                                              "enum": [
                                                                "word_match",
                                                                "partial_match"
                                                              ],
                                                              "default": "word_match"
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "keyword",
                                                            "searchFilter",
                                                            "matchType"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      ]
                                                    },
                                                    "minItems": 1,
                                                    "maxItems": 10
                                                  }
                                                },
                                                "required": [
                                                  "key",
                                                  "inputTargets",
                                                  "normalizedTargets"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 2,
                                              "maxItems": 10
                                            }
                                          },
                                          "required": [
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "unsupportedDimensions",
                                            "groups"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "unionMetrics": {
                                          "type": "object",
                                          "properties": {
                                            "total": {
                                              "type": "object",
                                              "properties": {
                                                "mentions": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                },
                                                "aiSearchVolume": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "mentions",
                                                "aiSearchVolume"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "sourceDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "searchResultDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brands": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brandCategories": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            }
                                          },
                                          "required": [
                                            "total",
                                            "sourceDomains",
                                            "searchResultDomains",
                                            "brands",
                                            "brandCategories"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "groups": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "key": {
                                                "type": "string"
                                              },
                                              "metrics": {
                                                "type": "object",
                                                "properties": {
                                                  "total": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  "sourceDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "searchResultDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brands": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brandCategories": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  }
                                                },
                                                "required": [
                                                  "total",
                                                  "sourceDomains",
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "key",
                                              "metrics",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 2,
                                          "maxItems": 10
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "missing",
                                        "unionMetrics",
                                        "groups"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-target-comparison",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_target_comparison",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-top-cited-pages/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-top-cited-pages",
        "description": "Provider ranked cited pages and their independent aggregate metrics. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiTopCitedPages",
        "externalDocs": {
          "description": "seo-ai-top-cited-pages documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-top-cited-pages"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "DOMAIN"
                            },
                            "domain": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Normalized ASCII hostname at most63 characters."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "includeSubdomains": {
                              "type": "boolean",
                              "default": false
                            }
                          },
                          "required": [
                            "kind",
                            "domain"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "KEYWORD"
                            },
                            "keyword": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "matchType": {
                              "type": "string",
                              "enum": [
                                "word_match",
                                "partial_match"
                              ],
                              "default": "word_match"
                            }
                          },
                          "required": [
                            "kind",
                            "keyword"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "google",
                      "chat_gpt"
                    ],
                    "default": "google"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": [
                  {
                    "kind": "DOMAIN",
                    "domain": " Example.COM "
                  },
                  {
                    "kind": "KEYWORD",
                    "keyword": " Shoes "
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "normalizedTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "google",
                                                "chat_gpt"
                                              ],
                                              "default": "google"
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "unsupportedDimensions": {
                                              "type": "array",
                                              "items": {
                                                "type": "string",
                                                "enum": [
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ]
                                              },
                                              "minItems": 0,
                                              "maxItems": 3
                                            },
                                            "ordering": {
                                              "type": "string",
                                              "const": "provider_default"
                                            },
                                            "linksScope": {
                                              "type": "string",
                                              "const": "sources"
                                            }
                                          },
                                          "required": [
                                            "inputTargets",
                                            "normalizedTargets",
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "unsupportedDimensions",
                                            "ordering",
                                            "linksScope"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "summary": {
                                          "type": "object",
                                          "properties": {
                                            "total": {
                                              "type": "object",
                                              "properties": {
                                                "mentions": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                },
                                                "aiSearchVolume": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "mentions",
                                                "aiSearchVolume"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "sourceDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "searchResultDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brands": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brandCategories": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            }
                                          },
                                          "required": [
                                            "total",
                                            "sourceDomains",
                                            "searchResultDomains",
                                            "brands",
                                            "brandCategories"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "totalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string"
                                              },
                                              "metrics": {
                                                "type": "object",
                                                "properties": {
                                                  "total": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  "sourceDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "searchResultDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brands": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brandCategories": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  }
                                                },
                                                "required": [
                                                  "total",
                                                  "sourceDomains",
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "metrics",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "missing",
                                        "summary",
                                        "totalCount",
                                        "items"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-top-cited-pages",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_top_cited_pages",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-top-cited-domains/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-top-cited-domains",
        "description": "Provider ranked cited domains without merging subdomains. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiTopCitedDomains",
        "externalDocs": {
          "description": "seo-ai-top-cited-domains documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-top-cited-domains"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "DOMAIN"
                            },
                            "domain": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Normalized ASCII hostname at most63 characters."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "includeSubdomains": {
                              "type": "boolean",
                              "default": false
                            }
                          },
                          "required": [
                            "kind",
                            "domain"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "KEYWORD"
                            },
                            "keyword": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "matchType": {
                              "type": "string",
                              "enum": [
                                "word_match",
                                "partial_match"
                              ],
                              "default": "word_match"
                            }
                          },
                          "required": [
                            "kind",
                            "keyword"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "google",
                      "chat_gpt"
                    ],
                    "default": "google"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": [
                  {
                    "kind": "DOMAIN",
                    "domain": " Example.COM "
                  },
                  {
                    "kind": "KEYWORD",
                    "keyword": " Shoes "
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "normalizedTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "google",
                                                "chat_gpt"
                                              ],
                                              "default": "google"
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "unsupportedDimensions": {
                                              "type": "array",
                                              "items": {
                                                "type": "string",
                                                "enum": [
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ]
                                              },
                                              "minItems": 0,
                                              "maxItems": 3
                                            },
                                            "ordering": {
                                              "type": "string",
                                              "const": "provider_default"
                                            },
                                            "linksScope": {
                                              "type": "string",
                                              "const": "sources"
                                            }
                                          },
                                          "required": [
                                            "inputTargets",
                                            "normalizedTargets",
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "unsupportedDimensions",
                                            "ordering",
                                            "linksScope"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "summary": {
                                          "type": "object",
                                          "properties": {
                                            "total": {
                                              "type": "object",
                                              "properties": {
                                                "mentions": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                },
                                                "aiSearchVolume": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "mentions",
                                                "aiSearchVolume"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "sourceDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "searchResultDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brands": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brandCategories": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            }
                                          },
                                          "required": [
                                            "total",
                                            "sourceDomains",
                                            "searchResultDomains",
                                            "brands",
                                            "brandCategories"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "totalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "domain": {
                                                "type": "string"
                                              },
                                              "metrics": {
                                                "type": "object",
                                                "properties": {
                                                  "total": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  "sourceDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "searchResultDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brands": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brandCategories": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  }
                                                },
                                                "required": [
                                                  "total",
                                                  "sourceDomains",
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "domain",
                                              "metrics",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "missing",
                                        "summary",
                                        "totalCount",
                                        "items"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-top-cited-domains",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_top_cited_domains",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-top-mentioned-brands/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-top-mentioned-brands",
        "description": "ChatGPT database brand mentions with provider brand taxonomy. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiTopMentionedBrands",
        "externalDocs": {
          "description": "seo-ai-top-mentioned-brands documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-top-mentioned-brands"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "DOMAIN"
                            },
                            "domain": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Normalized ASCII hostname at most63 characters."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "includeSubdomains": {
                              "type": "boolean",
                              "default": false
                            }
                          },
                          "required": [
                            "kind",
                            "domain"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "KEYWORD"
                            },
                            "keyword": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "matchType": {
                              "type": "string",
                              "enum": [
                                "word_match",
                                "partial_match"
                              ],
                              "default": "word_match"
                            }
                          },
                          "required": [
                            "kind",
                            "keyword"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "chat_gpt"
                    ],
                    "default": "chat_gpt"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": [
                  {
                    "kind": "DOMAIN",
                    "domain": " Example.COM "
                  },
                  {
                    "kind": "KEYWORD",
                    "keyword": " Shoes "
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "normalizedTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "chat_gpt"
                                              ],
                                              "default": "chat_gpt"
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "unsupportedDimensions": {
                                              "type": "array",
                                              "items": {
                                                "type": "string",
                                                "enum": [
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ]
                                              },
                                              "minItems": 0,
                                              "maxItems": 3
                                            },
                                            "ordering": {
                                              "type": "string",
                                              "const": "provider_default"
                                            },
                                            "taxonomy": {
                                              "type": "string",
                                              "const": "provider_brand_entities"
                                            }
                                          },
                                          "required": [
                                            "inputTargets",
                                            "normalizedTargets",
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "unsupportedDimensions",
                                            "ordering",
                                            "taxonomy"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "summary": {
                                          "type": "object",
                                          "properties": {
                                            "total": {
                                              "type": "object",
                                              "properties": {
                                                "mentions": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                },
                                                "aiSearchVolume": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "mentions",
                                                "aiSearchVolume"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "sourceDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "searchResultDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brands": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brandCategories": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            }
                                          },
                                          "required": [
                                            "total",
                                            "sourceDomains",
                                            "searchResultDomains",
                                            "brands",
                                            "brandCategories"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "totalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "brand": {
                                                "type": "string"
                                              },
                                              "metrics": {
                                                "type": "object",
                                                "properties": {
                                                  "total": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  "sourceDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "searchResultDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brands": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brandCategories": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  }
                                                },
                                                "required": [
                                                  "total",
                                                  "sourceDomains",
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "brand",
                                              "metrics",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "missing",
                                        "summary",
                                        "totalCount",
                                        "items"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-top-mentioned-brands",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_top_mentioned_brands",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-top-brand-categories/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-top-brand-categories",
        "description": "ChatGPT database brand categories with provider category labels. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiTopBrandCategories",
        "externalDocs": {
          "description": "seo-ai-top-brand-categories documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-top-brand-categories"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "DOMAIN"
                            },
                            "domain": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Normalized ASCII hostname at most63 characters."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "includeSubdomains": {
                              "type": "boolean",
                              "default": false
                            }
                          },
                          "required": [
                            "kind",
                            "domain"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "KEYWORD"
                            },
                            "keyword": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "matchType": {
                              "type": "string",
                              "enum": [
                                "word_match",
                                "partial_match"
                              ],
                              "default": "word_match"
                            }
                          },
                          "required": [
                            "kind",
                            "keyword"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "chat_gpt"
                    ],
                    "default": "chat_gpt"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": [
                  {
                    "kind": "DOMAIN",
                    "domain": " Example.COM "
                  },
                  {
                    "kind": "KEYWORD",
                    "keyword": " Shoes "
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "normalizedTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "chat_gpt"
                                              ],
                                              "default": "chat_gpt"
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "unsupportedDimensions": {
                                              "type": "array",
                                              "items": {
                                                "type": "string",
                                                "enum": [
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ]
                                              },
                                              "minItems": 0,
                                              "maxItems": 3
                                            },
                                            "ordering": {
                                              "type": "string",
                                              "const": "provider_default"
                                            },
                                            "taxonomy": {
                                              "type": "string",
                                              "const": "provider_brand_entities"
                                            }
                                          },
                                          "required": [
                                            "inputTargets",
                                            "normalizedTargets",
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "unsupportedDimensions",
                                            "ordering",
                                            "taxonomy"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "summary": {
                                          "type": "object",
                                          "properties": {
                                            "total": {
                                              "type": "object",
                                              "properties": {
                                                "mentions": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                },
                                                "aiSearchVolume": {
                                                  "type": [
                                                    "integer",
                                                    "null"
                                                  ],
                                                  "minimum": 0
                                                }
                                              },
                                              "required": [
                                                "mentions",
                                                "aiSearchVolume"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "sourceDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "searchResultDomains": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "domain": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "domain",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brands": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            },
                                            "brandCategories": {
                                              "type": [
                                                "array",
                                                "null"
                                              ],
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string"
                                                  },
                                                  "counts": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "counts"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 10
                                            }
                                          },
                                          "required": [
                                            "total",
                                            "sourceDomains",
                                            "searchResultDomains",
                                            "brands",
                                            "brandCategories"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "totalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "brandCategory": {
                                                "type": "string"
                                              },
                                              "metrics": {
                                                "type": "object",
                                                "properties": {
                                                  "total": {
                                                    "type": "object",
                                                    "properties": {
                                                      "mentions": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "aiSearchVolume": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "mentions",
                                                      "aiSearchVolume"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  "sourceDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "searchResultDomains": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "domain": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "domain",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brands": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  },
                                                  "brandCategories": {
                                                    "type": [
                                                      "array",
                                                      "null"
                                                    ],
                                                    "items": {
                                                      "type": "object",
                                                      "properties": {
                                                        "value": {
                                                          "type": "string"
                                                        },
                                                        "counts": {
                                                          "type": "object",
                                                          "properties": {
                                                            "mentions": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            },
                                                            "aiSearchVolume": {
                                                              "type": [
                                                                "integer",
                                                                "null"
                                                              ],
                                                              "minimum": 0
                                                            }
                                                          },
                                                          "required": [
                                                            "mentions",
                                                            "aiSearchVolume"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      },
                                                      "required": [
                                                        "value",
                                                        "counts"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    "minItems": 0,
                                                    "maxItems": 10
                                                  }
                                                },
                                                "required": [
                                                  "total",
                                                  "sourceDomains",
                                                  "searchResultDomains",
                                                  "brands",
                                                  "brandCategories"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "brandCategory",
                                              "metrics",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "missing",
                                        "summary",
                                        "totalCount",
                                        "items"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-top-brand-categories",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_top_brand_categories",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-mention-history/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-mention-history",
        "description": "Monthly absolute mentions from the provider historical database. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiMentionHistory",
        "externalDocs": {
          "description": "seo-ai-mention-history documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-mention-history"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "DOMAIN"
                            },
                            "domain": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Normalized ASCII hostname at most63 characters."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "includeSubdomains": {
                              "type": "boolean",
                              "default": false
                            }
                          },
                          "required": [
                            "kind",
                            "domain"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "KEYWORD"
                            },
                            "keyword": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "matchType": {
                              "type": "string",
                              "enum": [
                                "word_match",
                                "partial_match"
                              ],
                              "default": "word_match"
                            }
                          },
                          "required": [
                            "kind",
                            "keyword"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "google",
                      "chat_gpt"
                    ],
                    "default": "google"
                  },
                  "fromMonth": {
                    "type": "string",
                    "pattern": "^[0-9]{4}-[0-9]{2}$"
                  },
                  "toMonth": {
                    "type": "string",
                    "pattern": "^[0-9]{4}-[0-9]{2}$"
                  }
                },
                "required": [
                  "target",
                  "fromMonth",
                  "toMonth"
                ],
                "additionalProperties": false
              },
              "example": {
                "toMonth": "2025-09",
                "target": [
                  {
                    "kind": "DOMAIN",
                    "domain": " Example.COM "
                  }
                ],
                "fromMonth": "2025-08"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "normalizedTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "google",
                                                "chat_gpt"
                                              ]
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "measure": {
                                              "type": "string",
                                              "const": "monthly_absolute_mentions"
                                            },
                                            "fromMonth": {
                                              "type": "string",
                                              "pattern": "^[0-9]{4}-[0-9]{2}$"
                                            },
                                            "toMonth": {
                                              "type": "string",
                                              "pattern": "^[0-9]{4}-[0-9]{2}$"
                                            },
                                            "resolvedDateTo": {
                                              "type": "string",
                                              "format": "date"
                                            },
                                            "partialCalendarMonth": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "inputTargets",
                                            "normalizedTargets",
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "measure",
                                            "fromMonth",
                                            "toMonth",
                                            "resolvedDateTo",
                                            "partialCalendarMonth"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "year": {
                                                "type": "integer",
                                                "minimum": 1
                                              },
                                              "month": {
                                                "type": "integer",
                                                "minimum": 1,
                                                "maximum": 12
                                              },
                                              "metrics": {
                                                "type": "object",
                                                "properties": {
                                                  "mentions": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "aiSearchVolume": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "mentions",
                                                  "aiSearchVolume"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "year",
                                              "month",
                                              "metrics",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 12
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-mention-history",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_mention_history",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-mention-deltas/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-mention-deltas",
        "description": "Provider adjacent timestamp deltas with signed independent values. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiMentionDeltas",
        "externalDocs": {
          "description": "seo-ai-mention-deltas documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-mention-deltas"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "DOMAIN"
                            },
                            "domain": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Normalized ASCII hostname at most63 characters."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "includeSubdomains": {
                              "type": "boolean",
                              "default": false
                            }
                          },
                          "required": [
                            "kind",
                            "domain"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "KEYWORD"
                            },
                            "keyword": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "matchType": {
                              "type": "string",
                              "enum": [
                                "word_match",
                                "partial_match"
                              ],
                              "default": "word_match"
                            }
                          },
                          "required": [
                            "kind",
                            "keyword"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "google",
                      "chat_gpt"
                    ],
                    "default": "google"
                  },
                  "dateFrom": {
                    "type": "string",
                    "format": "date"
                  },
                  "dateTo": {
                    "type": "string",
                    "format": "date"
                  },
                  "groupRange": {
                    "type": "string",
                    "enum": [
                      "day",
                      "week",
                      "month",
                      "year"
                    ]
                  }
                },
                "required": [
                  "target",
                  "dateFrom",
                  "dateTo",
                  "groupRange"
                ],
                "additionalProperties": false
              },
              "example": {
                "dateTo": "2025-08-03",
                "target": [
                  {
                    "kind": "DOMAIN",
                    "domain": " Example.COM "
                  }
                ],
                "dateFrom": "2025-08-01",
                "groupRange": "week"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "normalizedTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "google",
                                                "chat_gpt"
                                              ]
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "measure": {
                                              "type": "string",
                                              "const": "provider_adjacent_timestamp_delta"
                                            },
                                            "dateFrom": {
                                              "type": "string",
                                              "format": "date"
                                            },
                                            "dateTo": {
                                              "type": "string",
                                              "format": "date"
                                            },
                                            "groupRange": {
                                              "type": "string",
                                              "enum": [
                                                "day",
                                                "week",
                                                "month",
                                                "year"
                                              ]
                                            }
                                          },
                                          "required": [
                                            "inputTargets",
                                            "normalizedTargets",
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "measure",
                                            "dateFrom",
                                            "dateTo",
                                            "groupRange"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "date": {
                                                "type": "string",
                                                "format": "date"
                                              },
                                              "mentionDelta": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": -9007199254740991
                                              },
                                              "aiSearchVolumeDelta": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": -9007199254740991
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "date",
                                              "mentionDelta",
                                              "aiSearchVolumeDelta",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 366
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-mention-deltas",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_mention_deltas",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-mention-new-lost/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "seo-ai-mention-new-lost",
        "description": "Provider new and lost mention statistics retained as separate nonnegative values. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.",
        "operationId": "runSeoAiMentionNewLost",
        "externalDocs": {
          "description": "seo-ai-mention-new-lost documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-mention-new-lost"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "DOMAIN"
                            },
                            "domain": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Normalized ASCII hostname at most63 characters."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "includeSubdomains": {
                              "type": "boolean",
                              "default": false
                            }
                          },
                          "required": [
                            "kind",
                            "domain"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "KEYWORD"
                            },
                            "keyword": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                            },
                            "searchFilter": {
                              "type": "string",
                              "enum": [
                                "include",
                                "exclude"
                              ],
                              "default": "include"
                            },
                            "matchType": {
                              "type": "string",
                              "enum": [
                                "word_match",
                                "partial_match"
                              ],
                              "default": "word_match"
                            }
                          },
                          "required": [
                            "kind",
                            "keyword"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 10
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "google",
                      "chat_gpt"
                    ],
                    "default": "google"
                  },
                  "dateFrom": {
                    "type": "string",
                    "format": "date"
                  },
                  "dateTo": {
                    "type": "string",
                    "format": "date"
                  },
                  "groupRange": {
                    "type": "string",
                    "enum": [
                      "day",
                      "week",
                      "month",
                      "year"
                    ]
                  }
                },
                "required": [
                  "target",
                  "dateFrom",
                  "dateTo",
                  "groupRange"
                ],
                "additionalProperties": false
              },
              "example": {
                "dateTo": "2025-08-03",
                "target": [
                  {
                    "kind": "DOMAIN",
                    "domain": " Example.COM "
                  }
                ],
                "dateFrom": "2025-08-01",
                "groupRange": "week"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "llm_mentions_database"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "normalizedTargets": {
                                              "type": "array",
                                              "items": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "DOMAIN"
                                                      },
                                                      "domain": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Normalized ASCII hostname at most63 characters."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "includeSubdomains": {
                                                        "type": "boolean",
                                                        "default": false
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "domain",
                                                      "searchFilter",
                                                      "includeSubdomains"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "KEYWORD"
                                                      },
                                                      "keyword": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."
                                                      },
                                                      "searchFilter": {
                                                        "type": "string",
                                                        "enum": [
                                                          "include",
                                                          "exclude"
                                                        ],
                                                        "default": "include"
                                                      },
                                                      "matchType": {
                                                        "type": "string",
                                                        "enum": [
                                                          "word_match",
                                                          "partial_match"
                                                        ],
                                                        "default": "word_match"
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "keyword",
                                                      "searchFilter",
                                                      "matchType"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ]
                                              },
                                              "minItems": 1,
                                              "maxItems": 10
                                            },
                                            "platform": {
                                              "type": "string",
                                              "enum": [
                                                "google",
                                                "chat_gpt"
                                              ]
                                            },
                                            "domainSearchScope": {
                                              "type": "string",
                                              "const": "sources"
                                            },
                                            "keywordSearchScope": {
                                              "type": "string",
                                              "const": "answer"
                                            },
                                            "measure": {
                                              "type": "string",
                                              "const": "provider_new_lost_statistics"
                                            },
                                            "dateFrom": {
                                              "type": "string",
                                              "format": "date"
                                            },
                                            "dateTo": {
                                              "type": "string",
                                              "format": "date"
                                            },
                                            "groupRange": {
                                              "type": "string",
                                              "enum": [
                                                "day",
                                                "week",
                                                "month",
                                                "year"
                                              ]
                                            }
                                          },
                                          "required": [
                                            "inputTargets",
                                            "normalizedTargets",
                                            "platform",
                                            "domainSearchScope",
                                            "keywordSearchScope",
                                            "measure",
                                            "dateFrom",
                                            "dateTo",
                                            "groupRange"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "date": {
                                                "type": "string",
                                                "format": "date"
                                              },
                                              "newMentions": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lostMentions": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "newAiSearchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lostAiSearchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "date",
                                              "newMentions",
                                              "lostMentions",
                                              "newAiSearchVolume",
                                              "lostAiSearchVolume",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 366
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-mention-new-lost",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_mention_new_lost",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ai-keyword-volume/run": {
      "post": {
        "tags": [
          "AI Search & Citations"
        ],
        "summary": "AI Keyword Search Volume Estimates",
        "description": "People Also Ask statistical estimates of AI keyword search volume. These are provider estimates, not measured ChatGPT queries or Google Ads volume. Preserve missing keywords and monthly observations.",
        "operationId": "runSeoAiKeywordVolume",
        "externalDocs": {
          "description": "AI Keyword Search Volume Estimates documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ai-keyword-volume"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Trim, NFC and lowercase,1..80 code points,at most10 words; ASCII percent and plus forbidden."
                    },
                    "minItems": 1,
                    "maxItems": 20
                  },
                  "market": {
                    "type": "string",
                    "const": "US",
                    "default": "US"
                  },
                  "language": {
                    "type": "string",
                    "const": "en",
                    "default": "en"
                  }
                },
                "required": [
                  "keywords"
                ],
                "additionalProperties": false
              },
              "example": {
                "keywords": [
                  " Shoes ",
                  "shoes"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "market": {
                                          "type": "string",
                                          "const": "US"
                                        },
                                        "language": {
                                          "type": "string",
                                          "const": "en"
                                        },
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "ai_optimization"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "ai_keyword_volume_estimate"
                                        },
                                        "context": {
                                          "type": "object",
                                          "properties": {
                                            "inputKeywords": {
                                              "type": "array",
                                              "items": {
                                                "type": "string"
                                              },
                                              "minItems": 1,
                                              "maxItems": 20
                                            },
                                            "normalizedKeywords": {
                                              "type": "array",
                                              "items": {
                                                "type": "string"
                                              },
                                              "minItems": 1,
                                              "maxItems": 20
                                            },
                                            "method": {
                                              "type": "string",
                                              "const": "provider_paa_statistical_estimate"
                                            }
                                          },
                                          "required": [
                                            "inputKeywords",
                                            "normalizedKeywords",
                                            "method"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": "string"
                                              },
                                              "aiSearchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "monthly": {
                                                "type": [
                                                  "array",
                                                  "null"
                                                ],
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "year": {
                                                      "type": "integer",
                                                      "minimum": 1
                                                    },
                                                    "month": {
                                                      "type": "integer",
                                                      "minimum": 1,
                                                      "maximum": 12
                                                    },
                                                    "aiSearchVolume": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "year",
                                                    "month",
                                                    "aiSearchVolume",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 12
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "aiSearchVolume",
                                              "monthly",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        }
                                      },
                                      "required": [
                                        "market",
                                        "language",
                                        "sourceProduct",
                                        "sourceKind",
                                        "context",
                                        "returnedCount",
                                        "truncated",
                                        "items",
                                        "missing"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ai-keyword-volume",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ai_keyword_volume",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-overview/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-backlink-overview",
        "description": "Bounded summary projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.",
        "operationId": "runSeoBacklinkOverview",
        "externalDocs": {
          "description": "seo-backlink-overview documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-overview"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "DOMAIN",
                          "PAGE"
                        ]
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048
                      }
                    },
                    "required": [
                      "kind",
                      "target"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": {
                  "kind": "DOMAIN",
                  "target": " Example.COM. "
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "normalizedTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "targetSpamScore": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "backlinksSpamScore": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "backlinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "crawledPages": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringMainDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringIps": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringSubnets": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "firstSeenAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lostAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "rank",
                                              "targetSpamScore",
                                              "backlinksSpamScore",
                                              "backlinks",
                                              "crawledPages",
                                              "referringDomains",
                                              "referringMainDomains",
                                              "referringIps",
                                              "referringSubnets",
                                              "firstSeenAt",
                                              "lostAt",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 1
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "status": {
                                          "type": "string",
                                          "const": "live"
                                        },
                                        "directLinksOnly": {
                                          "type": "boolean",
                                          "const": true
                                        },
                                        "rankScale": {
                                          "type": "integer",
                                          "const": 1000
                                        },
                                        "scope": {
                                          "type": "string",
                                          "enum": [
                                            "DOMAIN",
                                            "PAGE"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "status",
                                        "directLinksOnly",
                                        "rankScale",
                                        "scope"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-overview",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_overview",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-history/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-backlink-history",
        "description": "Bounded calendar history values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.",
        "operationId": "runSeoBacklinkHistory",
        "externalDocs": {
          "description": "seo-backlink-history documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-history"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  },
                  "fromMonth": {
                    "type": "string",
                    "pattern": "^[0-9]{4}-[0-9]{2}$"
                  },
                  "toMonth": {
                    "type": "string",
                    "pattern": "^[0-9]{4}-[0-9]{2}$"
                  }
                },
                "required": [
                  "target",
                  "fromMonth",
                  "toMonth"
                ],
                "additionalProperties": false
              },
              "example": {
                "toMonth": "2026-03",
                "target": "example.com",
                "fromMonth": "2026-03"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "normalizedTarget": {
                                          "type": "string"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "snapshotAt": {
                                                "type": "integer",
                                                "minimum": 0
                                              },
                                              "month": {
                                                "type": "string",
                                                "pattern": "^[0-9]{4}-[0-9]{2}$"
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "backlinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "crawledPages": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "internalLinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "externalLinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "composition": {
                                                "type": "object",
                                                "properties": {
                                                  "brokenBacklinks": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "brokenPages": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringDomains": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringMainDomains": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringPages": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringIps": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringSubnets": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringPagesNofollow": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "linkTypes": {
                                                    "type": "object",
                                                    "properties": {
                                                      "anchor": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "image": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "link": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "meta": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "canonical": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "alternate": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "redirect": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "anchor",
                                                      "image",
                                                      "link",
                                                      "meta",
                                                      "canonical",
                                                      "alternate",
                                                      "redirect"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "brokenBacklinks",
                                                  "brokenPages",
                                                  "referringDomains",
                                                  "referringMainDomains",
                                                  "referringPages",
                                                  "referringIps",
                                                  "referringSubnets",
                                                  "referringPagesNofollow",
                                                  "linkTypes"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "snapshotAt",
                                              "month",
                                              "rank",
                                              "backlinks",
                                              "crawledPages",
                                              "internalLinks",
                                              "externalLinks",
                                              "composition",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 12
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "fromMonth": {
                                          "type": "string"
                                        },
                                        "toMonth": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "fromMonth",
                                        "toMonth"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-history",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_history",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-records/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-backlink-records",
        "description": "Bounded backlinks projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.",
        "operationId": "runSeoBacklinkRecords",
        "externalDocs": {
          "description": "seo-backlink-records documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-records"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "DOMAIN",
                          "PAGE"
                        ]
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048
                      }
                    },
                    "required": [
                      "kind",
                      "target"
                    ],
                    "additionalProperties": false
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": {
                  "kind": "DOMAIN",
                  "target": " Example.COM. "
                },
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "normalizedTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "fromUrl": {
                                                "type": "string"
                                              },
                                              "toUrl": {
                                                "type": "string"
                                              },
                                              "anchor": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "dofollow": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "spamScore": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "firstSeenAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lastSeenAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "isNew": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "isLost": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "linksCount": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "fromUrl",
                                              "toUrl",
                                              "anchor",
                                              "dofollow",
                                              "rank",
                                              "spamScore",
                                              "firstSeenAt",
                                              "lastSeenAt",
                                              "isNew",
                                              "isLost",
                                              "linksCount",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "grouping": {
                                          "type": "string",
                                          "const": "provider_unique_referring_page"
                                        },
                                        "status": {
                                          "type": "string",
                                          "const": "live"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "providerTotalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "grouping",
                                        "status",
                                        "requestedLimit",
                                        "providerTotalCount"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-records",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_records",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-anchors/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-backlink-anchors",
        "description": "Bounded anchors projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.",
        "operationId": "runSeoBacklinkAnchors",
        "externalDocs": {
          "description": "seo-backlink-anchors documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-anchors"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "DOMAIN",
                          "PAGE"
                        ]
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048
                      }
                    },
                    "required": [
                      "kind",
                      "target"
                    ],
                    "additionalProperties": false
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": {
                  "kind": "DOMAIN",
                  "target": " Example.COM. "
                },
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "normalizedTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "anchor": {
                                                "type": "string"
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "backlinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringMainDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "backlinksSpamScore": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "firstSeenAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lostAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "anchor",
                                              "rank",
                                              "backlinks",
                                              "referringDomains",
                                              "referringMainDomains",
                                              "backlinksSpamScore",
                                              "firstSeenAt",
                                              "lostAt",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "sourceScope": {
                                          "type": "string",
                                          "const": "provider_default"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "providerTotalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "sourceScope",
                                        "requestedLimit",
                                        "providerTotalCount"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-anchors",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_anchors",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-domain-backlink-pages/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-domain-backlink-pages",
        "description": "Bounded domain pages projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.",
        "operationId": "runSeoDomainBacklinkPages",
        "externalDocs": {
          "description": "seo-domain-backlink-pages documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-domain-backlink-pages"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": " Example.COM. ",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "normalizedTarget": {
                                          "type": "string"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string"
                                              },
                                              "title": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "httpStatus": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 100,
                                                "maximum": 599
                                              },
                                              "lastCrawledAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "backlinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "referringDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "pageSpamScore": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "title",
                                              "httpStatus",
                                              "lastCrawledAt",
                                              "backlinks",
                                              "rank",
                                              "referringDomains",
                                              "pageSpamScore",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "sourceScope": {
                                          "type": "string",
                                          "const": "provider_default"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "providerTotalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "sourceScope",
                                        "requestedLimit",
                                        "providerTotalCount"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-domain-backlink-pages",
        "x-nexscope-mcp-tool-name": "nexscope_seo_domain_backlink_pages",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-page-backlink-composition/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "Page Backlink Composition",
        "description": "Bounded domain and page rank values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.",
        "operationId": "runSeoPageBacklinkComposition",
        "externalDocs": {
          "description": "Page Backlink Composition documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-page-backlink-composition"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "page": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2048,
                    "format": "uri"
                  }
                },
                "required": [
                  "page"
                ],
                "additionalProperties": false
              },
              "example": {
                "page": "HTTPS://www.example.com:443/A?b=2&a=1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "normalizedTarget": {
                                          "type": "string"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "url": {
                                                "type": "string"
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "backlinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "backlinksSpamScore": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "firstSeenAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lostAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "composition": {
                                                "type": "object",
                                                "properties": {
                                                  "brokenBacklinks": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "brokenPages": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringDomains": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringMainDomains": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringPages": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringIps": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringSubnets": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "referringPagesNofollow": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  },
                                                  "linkTypes": {
                                                    "type": "object",
                                                    "properties": {
                                                      "anchor": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "image": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "link": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "meta": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "canonical": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "alternate": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      },
                                                      "redirect": {
                                                        "type": [
                                                          "integer",
                                                          "null"
                                                        ],
                                                        "minimum": 0
                                                      }
                                                    },
                                                    "required": [
                                                      "anchor",
                                                      "image",
                                                      "link",
                                                      "meta",
                                                      "canonical",
                                                      "alternate",
                                                      "redirect"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                },
                                                "required": [
                                                  "brokenBacklinks",
                                                  "brokenPages",
                                                  "referringDomains",
                                                  "referringMainDomains",
                                                  "referringPages",
                                                  "referringIps",
                                                  "referringSubnets",
                                                  "referringPagesNofollow",
                                                  "linkTypes"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "url",
                                              "rank",
                                              "backlinks",
                                              "backlinksSpamScore",
                                              "firstSeenAt",
                                              "lostAt",
                                              "composition",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 1
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-page-backlink-composition",
        "x-nexscope-mcp-tool-name": "nexscope_seo_page_backlink_composition",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-referring-domains/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-referring-domains",
        "description": "Bounded referring domains projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.",
        "operationId": "runSeoReferringDomains",
        "externalDocs": {
          "description": "seo-referring-domains documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-referring-domains"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "DOMAIN",
                          "PAGE"
                        ]
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048
                      }
                    },
                    "required": [
                      "kind",
                      "target"
                    ],
                    "additionalProperties": false
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": {
                  "kind": "DOMAIN",
                  "target": " Example.COM. "
                },
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "normalizedTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "domain": {
                                                "type": "string"
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "backlinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringPages": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "firstSeenAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lostAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "domain",
                                              "rank",
                                              "backlinks",
                                              "referringPages",
                                              "firstSeenAt",
                                              "lostAt",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "sourceScope": {
                                          "type": "string",
                                          "const": "provider_default"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "providerTotalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "sourceScope",
                                        "requestedLimit",
                                        "providerTotalCount"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-referring-domains",
        "x-nexscope-mcp-tool-name": "nexscope_seo_referring_domains",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-referring-networks/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-referring-networks",
        "description": "Bounded referring networks projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.",
        "operationId": "runSeoReferringNetworks",
        "externalDocs": {
          "description": "seo-referring-networks documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-referring-networks"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "DOMAIN",
                          "PAGE"
                        ]
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048
                      }
                    },
                    "required": [
                      "kind",
                      "target"
                    ],
                    "additionalProperties": false
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  },
                  "networkType": {
                    "type": "string",
                    "enum": [
                      "IP",
                      "SUBNET"
                    ],
                    "default": "IP"
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "limit": 2,
                "networkType": "IP",
                "target": {
                  "kind": "DOMAIN",
                  "target": " Example.COM. "
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "normalizedTarget": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "networkAddress": {
                                                "type": "string"
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "backlinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringPages": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "firstSeenAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "networkType": {
                                                "type": "string",
                                                "enum": [
                                                  "IP",
                                                  "SUBNET"
                                                ]
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "networkAddress",
                                              "rank",
                                              "backlinks",
                                              "referringDomains",
                                              "referringPages",
                                              "firstSeenAt",
                                              "networkType",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "sourceScope": {
                                          "type": "string",
                                          "const": "provider_default"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "providerTotalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "networkType": {
                                          "type": "string",
                                          "enum": [
                                            "IP",
                                            "SUBNET"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "sourceScope",
                                        "requestedLimit",
                                        "providerTotalCount",
                                        "networkType"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-referring-networks",
        "x-nexscope-mcp-tool-name": "nexscope_seo_referring_networks",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-competitors/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-backlink-competitors",
        "description": "Bounded competitors projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.",
        "operationId": "runSeoBacklinkCompetitors",
        "externalDocs": {
          "description": "seo-backlink-competitors documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-competitors"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": " Example.COM. ",
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "normalizedTarget": {
                                          "type": "string"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "domain": {
                                                "type": "string"
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "intersections": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "domain",
                                              "rank",
                                              "intersections",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "excludedLargeDomains": {
                                          "type": "boolean",
                                          "const": true
                                        },
                                        "competitionBasis": {
                                          "type": "string",
                                          "const": "shared_backlink_profile"
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "providerTotalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "excludedLargeDomains",
                                        "competitionBasis",
                                        "requestedLimit",
                                        "providerTotalCount"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-competitors",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_competitors",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-domain-intersection/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-backlink-domain-intersection",
        "description": "Bounded domain and page rank values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.",
        "operationId": "runSeoBacklinkDomainIntersection",
        "externalDocs": {
          "description": "seo-backlink-domain-intersection documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-domain-intersection"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target1": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "DOMAIN",
                          "PAGE"
                        ]
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048
                      }
                    },
                    "required": [
                      "kind",
                      "target"
                    ],
                    "additionalProperties": false
                  },
                  "target2": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "DOMAIN",
                          "PAGE"
                        ]
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048
                      }
                    },
                    "required": [
                      "kind",
                      "target"
                    ],
                    "additionalProperties": false
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target1",
                  "target2"
                ],
                "additionalProperties": false
              },
              "example": {
                "target2": {
                  "kind": "PAGE",
                  "target": "https://second.example/page"
                },
                "target1": {
                  "kind": "DOMAIN",
                  "target": " Example.COM. "
                },
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget1": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "inputTarget2": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "normalizedTarget1": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "normalizedTarget2": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "providerTotalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "referringDomain": {
                                                "type": "string"
                                              },
                                              "first": {
                                                "type": "object",
                                                "properties": {
                                                  "rank": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0,
                                                    "maximum": 1000
                                                  },
                                                  "backlinks": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "rank",
                                                  "backlinks"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "second": {
                                                "type": "object",
                                                "properties": {
                                                  "rank": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0,
                                                    "maximum": 1000
                                                  },
                                                  "backlinks": {
                                                    "type": [
                                                      "integer",
                                                      "null"
                                                    ],
                                                    "minimum": 0
                                                  }
                                                },
                                                "required": [
                                                  "rank",
                                                  "backlinks"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "referringDomain",
                                              "first",
                                              "second",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget1",
                                        "inputTarget2",
                                        "normalizedTarget1",
                                        "normalizedTarget2",
                                        "requestedLimit",
                                        "providerTotalCount",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-domain-intersection",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_domain_intersection",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-page-intersection/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-backlink-page-intersection",
        "description": "Bounded domain and page rank values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.",
        "operationId": "runSeoBacklinkPageIntersection",
        "externalDocs": {
          "description": "seo-backlink-page-intersection documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-page-intersection"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target1": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "DOMAIN",
                          "PAGE"
                        ]
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048
                      }
                    },
                    "required": [
                      "kind",
                      "target"
                    ],
                    "additionalProperties": false
                  },
                  "target2": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "DOMAIN",
                          "PAGE"
                        ]
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2048
                      }
                    },
                    "required": [
                      "kind",
                      "target"
                    ],
                    "additionalProperties": false
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "target1",
                  "target2"
                ],
                "additionalProperties": false
              },
              "example": {
                "target2": {
                  "kind": "PAGE",
                  "target": "https://second.example/page"
                },
                "target1": {
                  "kind": "DOMAIN",
                  "target": " Example.COM. "
                },
                "limit": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget1": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "inputTarget2": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "normalizedTarget1": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "normalizedTarget2": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "DOMAIN",
                                                "PAGE"
                                              ]
                                            },
                                            "target": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 2048
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "target"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "requestedLimit": {
                                          "type": "integer",
                                          "minimum": 1
                                        },
                                        "providerTotalCount": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "referringPage": {
                                                "type": "string"
                                              },
                                              "first": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "fromUrl": {
                                                      "type": "string"
                                                    },
                                                    "toUrl": {
                                                      "type": "string"
                                                    },
                                                    "anchor": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "dofollow": {
                                                      "type": [
                                                        "boolean",
                                                        "null"
                                                      ]
                                                    },
                                                    "rank": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 1000
                                                    },
                                                    "spamScore": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 100
                                                    },
                                                    "firstSeenAt": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "lastSeenAt": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "isNew": {
                                                      "type": [
                                                        "boolean",
                                                        "null"
                                                      ]
                                                    },
                                                    "isLost": {
                                                      "type": [
                                                        "boolean",
                                                        "null"
                                                      ]
                                                    },
                                                    "linksCount": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "fromUrl",
                                                    "toUrl",
                                                    "anchor",
                                                    "dofollow",
                                                    "rank",
                                                    "spamScore",
                                                    "firstSeenAt",
                                                    "lastSeenAt",
                                                    "isNew",
                                                    "isLost",
                                                    "linksCount",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 1,
                                                "maxItems": 5
                                              },
                                              "second": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "fromUrl": {
                                                      "type": "string"
                                                    },
                                                    "toUrl": {
                                                      "type": "string"
                                                    },
                                                    "anchor": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "dofollow": {
                                                      "type": [
                                                        "boolean",
                                                        "null"
                                                      ]
                                                    },
                                                    "rank": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 1000
                                                    },
                                                    "spamScore": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0,
                                                      "maximum": 100
                                                    },
                                                    "firstSeenAt": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "lastSeenAt": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "isNew": {
                                                      "type": [
                                                        "boolean",
                                                        "null"
                                                      ]
                                                    },
                                                    "isLost": {
                                                      "type": [
                                                        "boolean",
                                                        "null"
                                                      ]
                                                    },
                                                    "linksCount": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "missing": {
                                                      "type": "array",
                                                      "items": {
                                                        "type": "object",
                                                        "properties": {
                                                          "field": {
                                                            "type": "string"
                                                          },
                                                          "reason": {
                                                            "type": "string",
                                                            "enum": [
                                                              "UPSTREAM_FIELD_MISSING",
                                                              "UPSTREAM_FIELD_INVALID",
                                                              "DUPLICATE_UPSTREAM_ITEM",
                                                              "UPSTREAM_ITEM_MISSING"
                                                            ]
                                                          }
                                                        },
                                                        "required": [
                                                          "field",
                                                          "reason"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      "minItems": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "fromUrl",
                                                    "toUrl",
                                                    "anchor",
                                                    "dofollow",
                                                    "rank",
                                                    "spamScore",
                                                    "firstSeenAt",
                                                    "lastSeenAt",
                                                    "isNew",
                                                    "isLost",
                                                    "linksCount",
                                                    "missing"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 1,
                                                "maxItems": 5
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "referringPage",
                                              "first",
                                              "second",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget1",
                                        "inputTarget2",
                                        "normalizedTarget1",
                                        "normalizedTarget2",
                                        "requestedLimit",
                                        "providerTotalCount",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-page-intersection",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_page_intersection",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-timeseries/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-backlink-timeseries",
        "description": "Bounded calendar history values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.",
        "operationId": "runSeoBacklinkTimeseries",
        "externalDocs": {
          "description": "seo-backlink-timeseries documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-timeseries"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  },
                  "dateFrom": {
                    "type": "string",
                    "format": "date"
                  },
                  "dateTo": {
                    "type": "string",
                    "format": "date"
                  },
                  "groupRange": {
                    "type": "string",
                    "enum": [
                      "DAY",
                      "WEEK",
                      "MONTH",
                      "YEAR"
                    ],
                    "default": "MONTH"
                  }
                },
                "required": [
                  "target",
                  "dateFrom",
                  "dateTo"
                ],
                "additionalProperties": false
              },
              "example": {
                "dateTo": "2026-05-13",
                "target": "example.com",
                "dateFrom": "2026-03-23",
                "groupRange": "MONTH"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "normalizedTarget": {
                                          "type": "string"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "bucketEndAt": {
                                                "type": "integer",
                                                "minimum": 0
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "backlinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "backlinksNofollow": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringMainDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "referringPages": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "bucketEndAt",
                                              "rank",
                                              "backlinks",
                                              "backlinksNofollow",
                                              "referringDomains",
                                              "referringMainDomains",
                                              "referringPages",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 366
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "requestedDateFrom": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "requestedDateTo": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "groupRange": {
                                          "type": "string",
                                          "enum": [
                                            "DAY",
                                            "WEEK",
                                            "MONTH",
                                            "YEAR"
                                          ]
                                        },
                                        "bucketPolicy": {
                                          "type": "string",
                                          "const": "provider_full_period"
                                        },
                                        "zeroMeaning": {
                                          "type": "string",
                                          "const": "provider_zero_or_no_data"
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "requestedDateFrom",
                                        "requestedDateTo",
                                        "groupRange",
                                        "bucketPolicy",
                                        "zeroMeaning"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-timeseries",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_timeseries",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-new-lost/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "seo-backlink-new-lost",
        "description": "Bounded calendar history values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.",
        "operationId": "runSeoBacklinkNewLost",
        "externalDocs": {
          "description": "seo-backlink-new-lost documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-new-lost"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  },
                  "dateFrom": {
                    "type": "string",
                    "format": "date"
                  },
                  "dateTo": {
                    "type": "string",
                    "format": "date"
                  },
                  "groupRange": {
                    "type": "string",
                    "enum": [
                      "DAY",
                      "WEEK",
                      "MONTH",
                      "YEAR"
                    ],
                    "default": "MONTH"
                  }
                },
                "required": [
                  "target",
                  "dateFrom",
                  "dateTo"
                ],
                "additionalProperties": false
              },
              "example": {
                "dateTo": "2026-05-13",
                "target": "example.com",
                "dateFrom": "2026-03-23",
                "groupRange": "MONTH"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTarget": {
                                          "type": "string"
                                        },
                                        "normalizedTarget": {
                                          "type": "string"
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "bucketEndAt": {
                                                "type": "integer",
                                                "minimum": 0
                                              },
                                              "newBacklinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lostBacklinks": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "newReferringDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lostReferringDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "newReferringMainDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lostReferringMainDomains": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "bucketEndAt",
                                              "newBacklinks",
                                              "lostBacklinks",
                                              "newReferringDomains",
                                              "lostReferringDomains",
                                              "newReferringMainDomains",
                                              "lostReferringMainDomains",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 366
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        },
                                        "requestedDateFrom": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "requestedDateTo": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "groupRange": {
                                          "type": "string",
                                          "enum": [
                                            "DAY",
                                            "WEEK",
                                            "MONTH",
                                            "YEAR"
                                          ]
                                        },
                                        "bucketPolicy": {
                                          "type": "string",
                                          "const": "provider_full_period"
                                        },
                                        "zeroMeaning": {
                                          "type": "string",
                                          "const": "provider_zero_or_no_data"
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTarget",
                                        "normalizedTarget",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated",
                                        "requestedDateFrom",
                                        "requestedDateTo",
                                        "groupRange",
                                        "bucketPolicy",
                                        "zeroMeaning"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-new-lost",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_new_lost",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-authority-ranks/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "Nexscope Authority Ranks",
        "description": "Bounded domain and page rank values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.",
        "operationId": "runSeoBacklinkAuthorityRanks",
        "externalDocs": {
          "description": "Nexscope Authority Ranks documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-authority-ranks"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "targets": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "DOMAIN",
                            "PAGE"
                          ]
                        },
                        "target": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        }
                      },
                      "required": [
                        "kind",
                        "target"
                      ],
                      "additionalProperties": false
                    },
                    "minItems": 1,
                    "maxItems": 20
                  }
                },
                "required": [
                  "targets"
                ],
                "additionalProperties": false
              },
              "example": {
                "targets": [
                  {
                    "kind": "DOMAIN",
                    "target": " Example.COM. "
                  },
                  {
                    "kind": "DOMAIN",
                    "target": "example.com"
                  },
                  {
                    "kind": "PAGE",
                    "target": "HTTPS://www.example.com:443/A?b=2&a=1"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTargets": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "DOMAIN",
                                                  "PAGE"
                                                ]
                                              },
                                              "target": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 2048
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "target"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "normalizedTargets": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "DOMAIN",
                                                  "PAGE"
                                                ]
                                              },
                                              "target": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 2048
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "target"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "target": {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "enum": [
                                                      "DOMAIN",
                                                      "PAGE"
                                                    ]
                                                  },
                                                  "target": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "maxLength": 2048
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "target"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "rank": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 1000
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "rank",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTargets",
                                        "normalizedTargets",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-authority-ranks",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_authority_ranks",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-backlink-spam-scores/run": {
      "post": {
        "tags": [
          "Backlinks & Authority"
        ],
        "summary": "Target Spam Scores",
        "description": "Bounded domain and page targetSpamScore values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.",
        "operationId": "runSeoBacklinkSpamScores",
        "externalDocs": {
          "description": "Target Spam Scores documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-backlink-spam-scores"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "targets": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "DOMAIN",
                            "PAGE"
                          ]
                        },
                        "target": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2048
                        }
                      },
                      "required": [
                        "kind",
                        "target"
                      ],
                      "additionalProperties": false
                    },
                    "minItems": 1,
                    "maxItems": 20
                  }
                },
                "required": [
                  "targets"
                ],
                "additionalProperties": false
              },
              "example": {
                "targets": [
                  {
                    "kind": "DOMAIN",
                    "target": " Example.COM. "
                  },
                  {
                    "kind": "DOMAIN",
                    "target": "example.com"
                  },
                  {
                    "kind": "PAGE",
                    "target": "HTTPS://www.example.com:443/A?b=2&a=1"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "sourceProduct": {
                                          "type": "string",
                                          "const": "backlinks"
                                        },
                                        "sourceKind": {
                                          "type": "string",
                                          "const": "dataforseo_backlink_index"
                                        },
                                        "inputTargets": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "DOMAIN",
                                                  "PAGE"
                                                ]
                                              },
                                              "target": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 2048
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "target"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "normalizedTargets": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "DOMAIN",
                                                  "PAGE"
                                                ]
                                              },
                                              "target": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 2048
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "target"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "returnedCount": {
                                          "type": "integer",
                                          "minimum": 0
                                        },
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "target": {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "enum": [
                                                      "DOMAIN",
                                                      "PAGE"
                                                    ]
                                                  },
                                                  "target": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "maxLength": 2048
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "target"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "targetSpamScore": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "maximum": 100
                                              },
                                              "missing": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "field": {
                                                      "type": "string"
                                                    },
                                                    "reason": {
                                                      "type": "string",
                                                      "enum": [
                                                        "UPSTREAM_FIELD_MISSING",
                                                        "UPSTREAM_FIELD_INVALID",
                                                        "DUPLICATE_UPSTREAM_ITEM",
                                                        "UPSTREAM_ITEM_MISSING"
                                                      ]
                                                    }
                                                  },
                                                  "required": [
                                                    "field",
                                                    "reason"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0
                                              }
                                            },
                                            "required": [
                                              "target",
                                              "targetSpamScore",
                                              "missing"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        },
                                        "missing": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "field": {
                                                "type": "string"
                                              },
                                              "reason": {
                                                "type": "string",
                                                "enum": [
                                                  "UPSTREAM_FIELD_MISSING",
                                                  "UPSTREAM_FIELD_INVALID",
                                                  "DUPLICATE_UPSTREAM_ITEM",
                                                  "UPSTREAM_ITEM_MISSING"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "field",
                                              "reason"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0
                                        },
                                        "truncated": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "sourceProduct",
                                        "sourceKind",
                                        "inputTargets",
                                        "normalizedTargets",
                                        "returnedCount",
                                        "items",
                                        "missing",
                                        "truncated"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-backlink-spam-scores",
        "x-nexscope-mcp-tool-name": "nexscope_seo_backlink_spam_scores",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-paid-keywords/run": {
      "post": {
        "tags": [
          "Advertising Intelligence"
        ],
        "summary": "seo-paid-keywords",
        "description": "Provider database paid keyword ranks with source measurement times. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.",
        "operationId": "runSeoPaidKeywords",
        "externalDocs": {
          "description": "seo-paid-keywords documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-paid-keywords"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100,
                    "default": 20
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": " Example.COM ",
                "limit": 100
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_LABS_PAID_RANKING"
                                            },
                                            "sampledAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "retrievedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": [
                                                    "string",
                                                    "null"
                                                  ],
                                                  "enum": [
                                                    "en",
                                                    null
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string"
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "keywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "searchVolume": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "cpc": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0,
                                                "description": "Provider USD CPC estimate, not account actual CPC."
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "url": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "title": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "description": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "measuredAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "searchVolume",
                                              "cpc",
                                              "rankGroup",
                                              "rankAbsolute",
                                              "url",
                                              "title",
                                              "description",
                                              "measuredAt"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 100
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "target",
                                        "keywords"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-paid-keywords",
        "x-nexscope-mcp-tool-name": "nexscope_seo_paid_keywords",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-search-ad-samples/run": {
      "post": {
        "tags": [
          "Advertising Intelligence"
        ],
        "summary": "seo-search-ad-samples",
        "description": "Single page US desktop paid search ad samples; ordinary punctuation preserved. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.",
        "operationId": "runSeoSearchAdSamples",
        "externalDocs": {
          "description": "seo-search-ad-samples documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-search-ad-samples"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "keyword"
                ],
                "additionalProperties": false
              },
              "example": {
                "keyword": " C++ ",
                "limit": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_GOOGLE_SERP_PAID_SAMPLE"
                                            },
                                            "sampledAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "retrievedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": [
                                                    "string",
                                                    "null"
                                                  ],
                                                  "enum": [
                                                    "en",
                                                    null
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string"
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "keyword": {
                                          "type": "string"
                                        },
                                        "ads": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "title": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "description": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "url": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "domain": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "page": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              }
                                            },
                                            "required": [
                                              "title",
                                              "description",
                                              "url",
                                              "domain",
                                              "rankGroup",
                                              "rankAbsolute",
                                              "page"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "keyword",
                                        "ads"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-search-ad-samples",
        "x-nexscope-mcp-tool-name": "nexscope_seo_search_ad_samples",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-advertiser-search/run": {
      "post": {
        "tags": [
          "Advertising Intelligence"
        ],
        "summary": "seo-advertiser-search",
        "description": "Single advertiser directory matches, with approximate ad counts. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.",
        "operationId": "runSeoAdvertiserSearch",
        "externalDocs": {
          "description": "seo-advertiser-search documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-advertiser-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 20
                  }
                },
                "required": [
                  "query"
                ],
                "additionalProperties": false
              },
              "example": {
                "query": "Acme",
                "limit": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_GOOGLE_ADVERTISER_DIRECTORY"
                                            },
                                            "sampledAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "retrievedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": [
                                                    "string",
                                                    "null"
                                                  ],
                                                  "enum": [
                                                    "en",
                                                    null
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string"
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "query": {
                                          "type": "string"
                                        },
                                        "advertisers": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "advertiserId": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "name": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "location": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "verified": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "approxAdsCount": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "rankGroup": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "rankAbsolute": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              }
                                            },
                                            "required": [
                                              "advertiserId",
                                              "name",
                                              "location",
                                              "verified",
                                              "approxAdsCount",
                                              "rankGroup",
                                              "rankAbsolute"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 20
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "query",
                                        "advertisers"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-advertiser-search",
        "x-nexscope-mcp-tool-name": "nexscope_seo_advertiser_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ad-transparency-search/run": {
      "post": {
        "tags": [
          "Advertising Intelligence"
        ],
        "summary": "seo-ad-transparency-search",
        "description": "Google Search transparency records over the provider default history. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.",
        "operationId": "runSeoAdTransparencySearch",
        "externalDocs": {
          "description": "seo-ad-transparency-search documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ad-transparency-search"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 254
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 40,
                    "default": 20
                  }
                },
                "required": [
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "target": "example.com",
                "limit": 20
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_GOOGLE_AD_TRANSPARENCY"
                                            },
                                            "sampledAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "retrievedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": [
                                                    "string",
                                                    "null"
                                                  ],
                                                  "enum": [
                                                    "en",
                                                    null
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string"
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            },
                                            "historyRange": {
                                              "type": "string",
                                              "const": "PROVIDER_DEFAULT_HISTORY"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow",
                                            "historyRange"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "target": {
                                          "type": "string"
                                        },
                                        "creatives": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "advertiserId": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "creativeId": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "advertiserName": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "recordUrl": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "verified": {
                                                "type": [
                                                  "boolean",
                                                  "null"
                                                ]
                                              },
                                              "format": {
                                                "type": "string",
                                                "enum": [
                                                  "TEXT",
                                                  "IMAGE",
                                                  "VIDEO",
                                                  "UNKNOWN"
                                                ]
                                              },
                                              "firstShownAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "lastShownAt": {
                                                "type": [
                                                  "integer",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "previews": {
                                                "type": "array",
                                                "items": {
                                                  "type": "object",
                                                  "properties": {
                                                    "url": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ]
                                                    },
                                                    "width": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    },
                                                    "height": {
                                                      "type": [
                                                        "integer",
                                                        "null"
                                                      ],
                                                      "minimum": 0
                                                    }
                                                  },
                                                  "required": [
                                                    "url",
                                                    "width",
                                                    "height"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                "minItems": 0,
                                                "maxItems": 5
                                              }
                                            },
                                            "required": [
                                              "advertiserId",
                                              "creativeId",
                                              "advertiserName",
                                              "recordUrl",
                                              "verified",
                                              "format",
                                              "firstShownAt",
                                              "lastShownAt",
                                              "previews"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 0,
                                          "maxItems": 40
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "target",
                                        "creatives"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ad-transparency-search",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ad_transparency_search",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-keyword-ad-traffic-forecast/run": {
      "post": {
        "tags": [
          "Advertising Intelligence"
        ],
        "summary": "seo-keyword-ad-traffic-forecast",
        "description": "Google Ads keyword click, CPC and advertising spend forecasts over a frozen future date range. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.",
        "operationId": "runSeoKeywordAdTrafficForecast",
        "externalDocs": {
          "description": "seo-keyword-ad-traffic-forecast documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-keyword-ad-traffic-forecast"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    },
                    "minItems": 1,
                    "maxItems": 20
                  },
                  "bidUsd": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "match": {
                    "type": "string",
                    "enum": [
                      "EXACT",
                      "PHRASE",
                      "BROAD"
                    ],
                    "default": "EXACT"
                  },
                  "dateFrom": {
                    "type": "string",
                    "format": "date"
                  },
                  "dateTo": {
                    "type": "string",
                    "format": "date"
                  }
                },
                "required": [
                  "keywords",
                  "bidUsd",
                  "dateFrom",
                  "dateTo"
                ],
                "additionalProperties": false
              },
              "example": {
                "dateTo": "2026-10-02",
                "keywords": [
                  " Shoes ",
                  "BOOTS"
                ],
                "bidUsd": 1,
                "dateFrom": "2026-10-01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_GOOGLE_ADS_FORECAST"
                                            },
                                            "sampledAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "retrievedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": [
                                                    "string",
                                                    "null"
                                                  ],
                                                  "enum": [
                                                    "en",
                                                    null
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string"
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "keywords": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "keyword": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              },
                                              "expectedClicks": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "averageCpcUsd": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              },
                                              "projectedSpendUsd": {
                                                "type": [
                                                  "number",
                                                  "null"
                                                ],
                                                "minimum": 0
                                              }
                                            },
                                            "required": [
                                              "keyword",
                                              "expectedClicks",
                                              "averageCpcUsd",
                                              "projectedSpendUsd"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "minItems": 1,
                                          "maxItems": 20
                                        },
                                        "dateFrom": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "dateTo": {
                                          "type": "string",
                                          "format": "date"
                                        },
                                        "bidUsd": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 100
                                        },
                                        "match": {
                                          "type": "string",
                                          "enum": [
                                            "EXACT",
                                            "PHRASE",
                                            "BROAD"
                                          ]
                                        },
                                        "currency": {
                                          "type": "string",
                                          "const": "USD"
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "keywords",
                                        "dateFrom",
                                        "dateTo",
                                        "bidUsd",
                                        "match",
                                        "currency"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-keyword-ad-traffic-forecast",
        "x-nexscope-mcp-tool-name": "nexscope_seo_keyword_ad_traffic_forecast",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/seo-ad-audience-estimate/run": {
      "post": {
        "tags": [
          "Advertising Intelligence"
        ],
        "summary": "seo-ad-audience-estimate",
        "description": "Bing monthly aggregate audience ranges under a separate daily advertising budget. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.",
        "operationId": "runSeoAdAudienceEstimate",
        "externalDocs": {
          "description": "seo-ad-audience-estimate documentation",
          "url": "https://www.nexscope.ai/api-docs/seo-ad-audience-estimate"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ageBands": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "A18_24",
                        "A25_34",
                        "A35_49",
                        "A50_64",
                        "A65_PLUS"
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 5,
                    "uniqueItems": true
                  },
                  "gender": {
                    "type": "string",
                    "enum": [
                      "MALE",
                      "FEMALE",
                      "UNKNOWN"
                    ]
                  },
                  "bidUsd": {
                    "type": "number",
                    "minimum": 0.01,
                    "maximum": 100,
                    "multipleOf": 0.01
                  },
                  "dailyBudgetUsd": {
                    "type": "number",
                    "minimum": 1,
                    "maximum": 1000,
                    "multipleOf": 0.01
                  }
                },
                "required": [
                  "ageBands",
                  "gender",
                  "bidUsd",
                  "dailyBudgetUsd"
                ],
                "additionalProperties": false
              },
              "example": {
                "bidUsd": 0.01,
                "gender": "UNKNOWN",
                "dailyBudgetUsd": 1,
                "ageBands": [
                  "A65_PLUS",
                  "A18_24"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "required": [
                                "callId",
                                "status",
                                "result"
                              ],
                              "type": "object",
                              "properties": {
                                "result": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "meta": {
                                          "type": "object",
                                          "properties": {
                                            "source": {
                                              "type": "string",
                                              "const": "DATAFORSEO_BING_AUDIENCE_ESTIMATE"
                                            },
                                            "sampledAt": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "retrievedAt": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991
                                            },
                                            "market": {
                                              "type": "object",
                                              "properties": {
                                                "country": {
                                                  "type": "string",
                                                  "const": "US"
                                                },
                                                "locationCode": {
                                                  "type": "integer",
                                                  "const": 2840
                                                },
                                                "language": {
                                                  "type": [
                                                    "string",
                                                    "null"
                                                  ],
                                                  "enum": [
                                                    "en",
                                                    null
                                                  ]
                                                }
                                              },
                                              "required": [
                                                "country",
                                                "locationCode",
                                                "language"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "truncated": {
                                              "type": "boolean"
                                            },
                                            "missing": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "path": {
                                                    "type": "string"
                                                  },
                                                  "reason": {
                                                    "type": "string",
                                                    "enum": [
                                                      "MISSING",
                                                      "NULL",
                                                      "INVALID",
                                                      "UNSUPPORTED",
                                                      "TRUNCATED"
                                                    ]
                                                  }
                                                },
                                                "required": [
                                                  "path",
                                                  "reason"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "minItems": 0,
                                              "maxItems": 100
                                            },
                                            "missingOverflow": {
                                              "type": "boolean"
                                            }
                                          },
                                          "required": [
                                            "source",
                                            "sampledAt",
                                            "retrievedAt",
                                            "market",
                                            "truncated",
                                            "missing",
                                            "missingOverflow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "ageBands": {
                                          "type": "array",
                                          "items": {
                                            "type": "string",
                                            "enum": [
                                              "A18_24",
                                              "A25_34",
                                              "A35_49",
                                              "A50_64",
                                              "A65_PLUS"
                                            ]
                                          },
                                          "minItems": 1,
                                          "maxItems": 5
                                        },
                                        "gender": {
                                          "type": "string",
                                          "enum": [
                                            "MALE",
                                            "FEMALE",
                                            "UNKNOWN"
                                          ]
                                        },
                                        "bidUsd": {
                                          "type": "number",
                                          "minimum": 0.01,
                                          "maximum": 100
                                        },
                                        "dailyBudgetUsd": {
                                          "type": "number",
                                          "minimum": 1,
                                          "maximum": 1000
                                        },
                                        "currency": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "enum": [
                                            "USD",
                                            null
                                          ]
                                        },
                                        "period": {
                                          "type": "string",
                                          "const": "MONTHLY"
                                        },
                                        "impressions": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "low": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "high": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "low",
                                            "high"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "audienceSize": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "low": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "high": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "low",
                                            "high"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "clicks": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "low": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "high": {
                                              "type": [
                                                "integer",
                                                "null"
                                              ],
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "low",
                                            "high"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "spend": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "low": {
                                              "type": [
                                                "number",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "high": {
                                              "type": [
                                                "number",
                                                "null"
                                              ],
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "low",
                                            "high"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "costPerEvent": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "properties": {
                                            "low": {
                                              "type": [
                                                "number",
                                                "null"
                                              ],
                                              "minimum": 0
                                            },
                                            "high": {
                                              "type": [
                                                "number",
                                                "null"
                                              ],
                                              "minimum": 0
                                            }
                                          },
                                          "required": [
                                            "low",
                                            "high"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "suggestedBid": {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "suggestedDailyBudget": {
                                          "type": [
                                            "number",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "reachAudienceSize": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        },
                                        "reachImpressions": {
                                          "type": [
                                            "integer",
                                            "null"
                                          ],
                                          "minimum": 0
                                        }
                                      },
                                      "required": [
                                        "meta",
                                        "ageBands",
                                        "gender",
                                        "bidUsd",
                                        "dailyBudgetUsd",
                                        "currency",
                                        "period",
                                        "impressions",
                                        "audienceSize",
                                        "clicks",
                                        "spend",
                                        "costPerEvent",
                                        "suggestedBid",
                                        "suggestedDailyBudget",
                                        "reachAudienceSize",
                                        "reachImpressions"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "callId": {
                                  "type": "string"
                                },
                                "schemaVersion": {
                                  "type": "string"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "requestedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "completedAt": {
                                  "type": [
                                    "string",
                                    "integer",
                                    "null"
                                  ]
                                },
                                "coverage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ]
                                },
                                "usage": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "billingStatus": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "chargedCredits": {
                                      "type": [
                                        "string",
                                        "integer",
                                        "null"
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              }
                            },
                            {
                              "not": {
                                "required": [
                                  "result"
                                ]
                              },
                              "properties": {
                                "reason": {
                                  "type": "string"
                                },
                                "taskId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "retryable": {
                                  "type": "boolean"
                                },
                                "status": {
                                  "type": "string"
                                },
                                "callId": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "type": "object",
                              "required": [
                                "callId",
                                "status",
                                "reason",
                                "retryable"
                              ]
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "reason": "IN_PROGRESS",
                    "retryable": false,
                    "status": "PROCESSING",
                    "callId": "00000000-0000-4000-8000-000000000001"
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "seo-ad-audience-estimate",
        "x-nexscope-mcp-tool-name": "nexscope_seo_ad_audience_estimate",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/gpt-image-2-5-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "GPT Image 2.5 Sunburst",
        "description": "Create and edit ecommerce visuals with precise instruction following, broad visual-style support, world-knowledge grounding, and reliable text rendering through the GPT Image 2.5 Sunburst route. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runGptImage25Generation",
        "externalDocs": {
          "description": "GPT Image 2.5 Sunburst documentation",
          "url": "https://www.nexscope.ai/api-docs/gpt-image-2-5-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Create and edit ecommerce visuals with precise instruction following, broad visual-style support, world-knowledge grounding, and reliable text rendering through the GPT Image 2.5 Sunburst route.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional public reference image URLs. Omit this field for text-to-image generation, or provide references for image-to-image generation. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [],
                    "minItems": 0,
                    "maxItems": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K, 2K, or 4K; defaults to 2K.",
                    "example": "2K",
                    "enum": [
                      "1K",
                      "2K",
                      "4K"
                    ]
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 3:4, 4:3, 2:3, 3:2, 9:16, 16:9, 4:5, 5:4, 21:9, 9:21.",
                    "example": "1:1",
                    "enum": [
                      "1:1",
                      "3:4",
                      "4:3",
                      "2:3",
                      "3:2",
                      "9:16",
                      "16:9",
                      "4:5",
                      "5:4",
                      "21:9",
                      "9:21"
                    ]
                  },
                  "quality": {
                    "type": "string",
                    "description": "GPT Image quality. Supported values: low, medium, high, xhigh, max. Defaults to medium.",
                    "example": "medium",
                    "enum": [
                      "low",
                      "medium",
                      "high",
                      "xhigh",
                      "max"
                    ]
                  }
                },
                "required": [
                  "prompt"
                ],
                "example": {
                  "imageUrls": [],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "2K",
                  "aspectRatio": "1:1",
                  "quality": "medium"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "2K",
                "aspectRatio": "1:1",
                "quality": "medium"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "gpt-image-2-5-generation",
        "x-nexscope-mcp-tool-name": "nexscope_gpt_image_2_5_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/gpt-image-2-5-flare-generation/run": {
      "post": {
        "tags": [
          "Image Generation Models"
        ],
        "summary": "GPT Image 2.5 Flare",
        "description": "Create and edit ecommerce visuals with detailed instruction following, flexible visual styles, world-knowledge grounding, and dependable text rendering through the GPT Image 2.5 Flare route. The model is fixed by this API, so provider must not be supplied in the request.",
        "operationId": "runGptImage25FlareGeneration",
        "externalDocs": {
          "description": "GPT Image 2.5 Flare documentation",
          "url": "https://www.nexscope.ai/api-docs/gpt-image-2-5-flare-generation"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Create and edit ecommerce visuals with detailed instruction following, flexible visual styles, world-knowledge grounding, and dependable text rendering through the GPT Image 2.5 Flare route.",
                "properties": {
                  "imageUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Optional public reference image URLs. Omit this field for text-to-image generation, or provide references for image-to-image generation. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.",
                    "example": [],
                    "minItems": 0,
                    "maxItems": 10
                  },
                  "prompt": {
                    "type": "string",
                    "description": "Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.",
                    "example": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                    "maxLength": 5000
                  },
                  "outputNum": {
                    "type": "integer",
                    "description": "Number of images to generate. Valid range: 1 to 10; defaults to 1.",
                    "example": 1,
                    "minimum": 1,
                    "maximum": 10
                  },
                  "resolution": {
                    "type": "string",
                    "description": "Output resolution. Supported values: 1K, 2K, or 4K; defaults to 2K.",
                    "example": "2K",
                    "enum": [
                      "1K",
                      "2K",
                      "4K"
                    ]
                  },
                  "aspectRatio": {
                    "type": "string",
                    "description": "Output aspect ratio. Supported values: 1:1, 3:4, 4:3, 2:3, 3:2, 9:16, 16:9, 4:5, 5:4, 21:9, 9:21.",
                    "example": "1:1",
                    "enum": [
                      "1:1",
                      "3:4",
                      "4:3",
                      "2:3",
                      "3:2",
                      "9:16",
                      "16:9",
                      "4:5",
                      "5:4",
                      "21:9",
                      "9:21"
                    ]
                  },
                  "quality": {
                    "type": "string",
                    "description": "GPT Image quality. Supported values: low, medium, high, xhigh, max. Defaults to medium.",
                    "example": "medium",
                    "enum": [
                      "low",
                      "medium",
                      "high",
                      "xhigh",
                      "max"
                    ]
                  }
                },
                "required": [
                  "prompt"
                ],
                "example": {
                  "imageUrls": [],
                  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                  "outputNum": 1,
                  "resolution": "2K",
                  "aspectRatio": "1:1",
                  "quality": "medium"
                },
                "additionalProperties": true
              },
              "example": {
                "imageUrls": [],
                "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
                "outputNum": 1,
                "resolution": "2K",
                "aspectRatio": "1:1",
                "quality": "medium"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "result": {
                              "anyOf": [
                                {
                                  "description": "Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.",
                                  "type": "object",
                                  "additionalProperties": true
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "status": {
                              "enum": [
                                "PENDING",
                                "RUNNING",
                                "SUCCEEDED",
                                "FAILED",
                                "TIMEOUT"
                              ],
                              "type": "string"
                            },
                            "taskId": {
                              "type": "string"
                            }
                          },
                          "type": "object",
                          "required": [
                            "taskId",
                            "status",
                            "result"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "example": {
                  "data": {
                    "taskId": "example-task",
                    "status": "PENDING",
                    "result": null
                  },
                  "code": 0,
                  "msg": null,
                  "ts": "0",
                  "time": "2026-01-01 00:00:00",
                  "cost": "-1",
                  "traceId": null
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "409": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "410": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "413": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "x-nexscope-slug": "gpt-image-2-5-flare-generation",
        "x-nexscope-mcp-tool-name": "nexscope_gpt_image_2_5_flare_generation",
        "x-nexscope-pricing-mode": "dynamic-credits",
        "x-nexscope-catalog-derived": true,
        "parameters": [
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    },
    "/api/skill-api/v1/mcp": {
      "get": {
        "summary": "Get MCP tool metadata, optionally by category",
        "operationId": "getSkillApiMcpManifest",
        "security": [],
        "responses": {
          "200": {
            "description": "Metadata only. Read code for success or a category validation error; execution authentication and billing are unchanged.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "properties": {
                            "tools": {
                              "items": {
                                "properties": {
                                  "description": {
                                    "type": "string"
                                  },
                                  "name": {
                                    "type": "string"
                                  },
                                  "outputSchema": {
                                    "type": "object"
                                  },
                                  "inputSchema": {
                                    "type": "object"
                                  }
                                },
                                "type": "object",
                                "required": [
                                  "name",
                                  "description",
                                  "inputSchema",
                                  "outputSchema"
                                ]
                              },
                              "type": "array"
                            }
                          },
                          "type": "object",
                          "required": [
                            "tools"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "description": "Optional category slug for tool metadata. Does not scope the MCP connection or change authentication, execution, or billing.",
            "in": "query",
            "name": "category",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/api/skill-api/v1/skills/{slug}/tasks/{taskId}": {
      "get": {
        "summary": "Query an existing asynchronous task using its originating skill",
        "operationId": "getSkillApiTaskResult",
        "responses": {
          "200": {
            "description": "Read code and data.status. Acceptance or a running task is not completion; the public data shape depends on the originating media or SEO API.",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "code",
                    "msg",
                    "data",
                    "ts",
                    "time",
                    "cost",
                    "traceId"
                  ],
                  "type": "object",
                  "properties": {
                    "data": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "code": {
                      "description": "0 means accepted or successful; nonzero is a platform error.",
                      "type": "integer"
                    },
                    "msg": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ts": {
                      "description": "Epoch milliseconds.",
                      "type": "string"
                    },
                    "time": {
                      "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
                      "type": "string"
                    },
                    "cost": {
                      "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
                      "type": "string"
                    },
                    "traceId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "401": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "402": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "403": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "404": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "429": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "500": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "502": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "503": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          },
          "504": {
            "$ref": "#/components/responses/SkillApiSemanticError"
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/SkillApiHttpStatus"
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Nexscope API Key"
      }
    },
    "schemas": {
      "CommonError": {
        "type": "object",
        "description": "Common API error envelope. Exact fields may vary by endpoint and upstream provider.",
        "properties": {
          "code": {
            "oneOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ],
            "description": "Application or provider error code."
          },
          "msg": {
            "type": "string",
            "description": "Error message."
          },
          "message": {
            "type": "string",
            "description": "Alternative error message field."
          },
          "traceId": {
            "type": "string",
            "description": "Support trace identifier when available."
          }
        },
        "additionalProperties": true
      },
      "SkillApiErrorEnvelope": {
        "required": [
          "code",
          "msg",
          "data",
          "ts",
          "time",
          "cost",
          "traceId"
        ],
        "type": "object",
        "properties": {
          "data": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ]
          },
          "code": {
            "description": "0 means accepted or successful; nonzero is a platform error.",
            "type": "integer"
          },
          "msg": {
            "type": [
              "string",
              "null"
            ]
          },
          "ts": {
            "description": "Epoch milliseconds.",
            "type": "string"
          },
          "time": {
            "description": "Server local time: yyyy-MM-dd HH:mm:ss.",
            "type": "string"
          },
          "cost": {
            "description": "Elapsed milliseconds, never credits; -1 outside web requests.",
            "type": "string"
          },
          "traceId": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Invalid request parameters.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/CommonError"
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Missing or invalid API key.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/CommonError"
            }
          }
        }
      },
      "Forbidden": {
        "description": "The account or API key is not allowed to use this capability.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/CommonError"
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "Rate limit or account usage limit reached.",
        "headers": {
          "Retry-After": {
            "description": "Retry delay when returned by the service.",
            "schema": {
              "type": "integer"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/CommonError"
            }
          }
        }
      },
      "ServerError": {
        "description": "Server or upstream provider error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/CommonError"
            }
          }
        }
      },
      "SkillApiSemanticError": {
        "description": "Error status when X-Nexscope-Http-Status: semantic is used. Read the unchanged code/msg/data envelope.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/SkillApiErrorEnvelope"
            }
          }
        }
      }
    },
    "parameters": {
      "SkillApiHttpStatus": {
        "name": "X-Nexscope-Http-Status",
        "in": "header",
        "required": false,
        "description": "Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.",
        "schema": {
          "default": "legacy",
          "type": "string",
          "enum": [
            "legacy",
            "semantic"
          ]
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-nexscope-source": "https://api.nexscope.ai/api/skill-api/v1/api-docs",
  "x-nexscope-pricing-mode": "dynamic-credits",
  "x-nexscope-mcp-endpoint": "https://api.nexscope.ai/api/skill-api/v1/mcp"
}