@oomol-lab/open-connector 1.6.2 → 1.6.4

package/assets/open-connector/catalog/apps/linkfox.json

@@ -4717,6 +4717,626 @@
         "description": "Seerfar Ozon result with supplier metrics preserved."
       }
     },
+    {
+      "id": "linkfox.get_sif_asin_traffic_summary",
+      "service": "linkfox",
+      "name": "get_sif_asin_traffic_summary",
+      "description": "Summarize natural, advertising, and recommendation traffic sources for up to ten Amazon ASINs through LinkFox and SIF.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "searchValue": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1000,
+            "description": "One to ten comma-separated Amazon ASINs."
+          },
+          "country": {
+            "type": "string",
+            "enum": [
+              "US",
+              "UK",
+              "DE",
+              "CA",
+              "JP",
+              "FR",
+              "ES",
+              "IT",
+              "MX",
+              "AU",
+              "AE",
+              "BR",
+              "SA"
+            ],
+            "description": "The Amazon marketplace code. LinkFox defaults to US when omitted."
+          },
+          "last7d": {
+            "type": "boolean",
+            "description": "Whether to use the latest seven days. Set false to use startDate and endDate; LinkFox defaults to true."
+          },
+          "startDate": {
+            "type": "string",
+            "description": "The period start date, used when last7d is false.",
+            "format": "date"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "The period end date, paired with startDate.",
+            "format": "date"
+          },
+          "conditions": {
+            "type": "string",
+            "maxLength": 1000,
+            "description": "Comma-separated SIF filters: nf, sp, sb, sbv, ad, acAd, or totalPeriod.in."
+          },
+          "sortBy": {
+            "type": "string",
+            "enum": [
+              "totalKeywordNum",
+              "naturalKeywordNum",
+              "brandKeywordNum",
+              "vedioKeywordNum",
+              "acKeywordNum",
+              "erKeywordNum",
+              "trKeywordNum",
+              "sumScore",
+              "totalNfScore",
+              "totalSpSocre",
+              "totalBrandScore",
+              "totalVedioScore",
+              "totalAcScore",
+              "totalTrScore",
+              "totalErScore"
+            ],
+            "description": "The ASIN traffic-summary sort field."
+          },
+          "pageNum": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based result page. LinkFox defaults to 1."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 10,
+            "maximum": 10000,
+            "description": "The number of ASIN summaries per page. LinkFox defaults to 10000."
+          },
+          "desc": {
+            "type": "boolean",
+            "description": "Whether to sort descending. LinkFox defaults to true."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "searchValue"
+        ],
+        "description": "Parameters for summarizing SIF traffic sources by ASIN."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "The SIF business code; 1 indicates success."
+          },
+          "msg": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The SIF response message."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The number of records returned by this request."
+          },
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A SIF ASIN summary with product context, current and previous exposure scores, traffic shares, keyword counts, entry or exit counts, and source markers."
+            },
+            "description": "The SIF records returned by this request."
+          },
+          "columns": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A provider-defined rendering-column definition."
+            },
+            "description": "The LinkFox rendering-column definitions."
+          },
+          "type": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The LinkFox rendering style when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "title": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The result title when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "costTime": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "description": "The upstream processing time in milliseconds."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "costToken": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The LinkFox token cost when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "isParentAsin": {
+            "type": "boolean",
+            "description": "Whether the search target is a parent ASIN."
+          },
+          "variantsNum": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "description": "The number of variants with traffic keywords."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "noKeywordVariantsNum": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "description": "The number of variants without traffic keywords."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "code",
+          "msg",
+          "total",
+          "data",
+          "columns",
+          "type",
+          "title",
+          "costTime",
+          "costToken",
+          "variantsNum",
+          "noKeywordVariantsNum"
+        ],
+        "description": "SIF traffic-source summaries for Amazon ASINs."
+      }
+    },
+    {
+      "id": "linkfox.get_sif_keyword_overview",
+      "service": "linkfox",
+      "name": "get_sif_keyword_overview",
+      "description": "Get SIF search demand, supply-demand ratio, and advertising or recommendation competition for one Amazon keyword through LinkFox.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "keyword": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1000,
+            "description": "The localized Amazon keyword to analyze."
+          },
+          "country": {
+            "type": "string",
+            "enum": [
+              "US",
+              "UK",
+              "DE",
+              "CA",
+              "JP",
+              "FR",
+              "ES",
+              "IT",
+              "MX",
+              "AU",
+              "AE",
+              "BR",
+              "SA"
+            ],
+            "description": "The Amazon marketplace code. LinkFox defaults to US when omitted."
+          },
+          "last7d": {
+            "type": "boolean",
+            "description": "Whether to use the latest seven days. Set false to use startDate and endDate; LinkFox defaults to true."
+          },
+          "startDate": {
+            "type": "string",
+            "description": "The period start date, used when last7d is false.",
+            "format": "date"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "The period end date, paired with startDate.",
+            "format": "date"
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "keyword"
+        ],
+        "description": "Parameters for retrieving a SIF keyword overview."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "The SIF business code; 1 indicates success."
+          },
+          "msg": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The SIF response message."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The number of records returned by this request."
+          },
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A SIF keyword overview with search volume, supply-demand ratio, product counts by traffic placement, tracked ASIN totals, and data-period timestamps."
+            },
+            "description": "The SIF records returned by this request."
+          },
+          "columns": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A provider-defined rendering-column definition."
+            },
+            "description": "The LinkFox rendering-column definitions."
+          },
+          "type": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The LinkFox rendering style when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "title": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The result title when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "costTime": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "description": "The upstream processing time in milliseconds."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "costToken": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The LinkFox token cost when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "code",
+          "msg",
+          "total",
+          "data",
+          "columns",
+          "type",
+          "title",
+          "costTime",
+          "costToken"
+        ],
+        "description": "A SIF market-competition overview for one Amazon keyword."
+      }
+    },
+    {
+      "id": "linkfox.get_sif_keyword_traffic_summary",
+      "service": "linkfox",
+      "name": "get_sif_keyword_traffic_summary",
+      "description": "Analyze competitor ASIN traffic shares and natural, advertising, or recommendation exposure for one Amazon keyword through LinkFox and SIF.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "searchKeyword": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1000,
+            "description": "The localized Amazon keyword to analyze."
+          },
+          "country": {
+            "type": "string",
+            "enum": [
+              "US",
+              "UK",
+              "DE",
+              "CA",
+              "JP",
+              "FR",
+              "ES",
+              "IT",
+              "MX",
+              "AU",
+              "AE",
+              "BR",
+              "SA"
+            ],
+            "description": "The Amazon marketplace code. LinkFox defaults to US when omitted."
+          },
+          "asins": {
+            "type": "string",
+            "maxLength": 1000,
+            "description": "An optional comma-separated ASIN filter."
+          },
+          "condition": {
+            "type": "string",
+            "enum": [
+              "nfPosition",
+              "isSpAd",
+              "isVedioAd",
+              "isBrandAd",
+              "isPPCAd",
+              "isSearchRecommend",
+              "acAd",
+              "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"
+            ],
+            "description": "One SIF traffic or period filter, such as nfPosition, isSpAd, isBrandAd, isPPCAd, acAd, or totalPeriod.in."
+          },
+          "last7d": {
+            "type": "boolean",
+            "description": "Whether to use the latest seven days. Set false to use startDate and endDate; LinkFox defaults to true."
+          },
+          "startDate": {
+            "type": "string",
+            "description": "The period start date, used when last7d is false.",
+            "format": "date"
+          },
+          "endDate": {
+            "type": "string",
+            "description": "The period end date, paired with startDate.",
+            "format": "date"
+          },
+          "sortBy": {
+            "type": "string",
+            "enum": [
+              "totalKeywordNum",
+              "naturalKeywordNum",
+              "brandKeywordNum",
+              "vedioKeywordNum",
+              "acKeywordNum",
+              "erKeywordNum",
+              "trKeywordNum",
+              "sumScore",
+              "totalNfScore",
+              "totalSpSocre",
+              "totalBrandScore",
+              "totalVedioScore",
+              "totalAcScore",
+              "totalTrScore",
+              "totalErScore"
+            ],
+            "description": "The competitor traffic-summary sort field."
+          },
+          "pageNum": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based result page. LinkFox defaults to 1."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 10,
+            "maximum": 100,
+            "description": "The number of competitor ASINs per page. LinkFox defaults to 100."
+          },
+          "desc": {
+            "type": "boolean",
+            "description": "Whether to sort descending. LinkFox defaults to true."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "searchKeyword"
+        ],
+        "description": "Parameters for summarizing competitor traffic sources for one keyword."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "The SIF business code; 1 indicates success."
+          },
+          "msg": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The SIF response message."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The number of records returned by this request."
+          },
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A SIF competitor record with product context, overall and queried-keyword exposure scores, traffic shares, and source markers."
+            },
+            "description": "The SIF records returned by this request."
+          },
+          "columns": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A provider-defined rendering-column definition."
+            },
+            "description": "The LinkFox rendering-column definitions."
+          },
+          "type": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The LinkFox rendering style when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "title": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The result title when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "costTime": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "description": "The upstream processing time in milliseconds."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "costToken": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The LinkFox token cost when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "code",
+          "msg",
+          "total",
+          "data",
+          "columns",
+          "type",
+          "title",
+          "costTime",
+          "costToken"
+        ],
+        "description": "SIF competitor traffic-source summaries for one Amazon keyword."
+      }
+    },
     {
       "id": "linkfox.get_tiktok_shop_product",
       "service": "linkfox",
@@ -10917,6 +11537,222 @@
         "description": "Seerfar Ozon result with supplier metrics preserved."
       }
     },
+    {
+      "id": "linkfox.list_sif_asin_keywords",
+      "service": "linkfox",
+      "name": "list_sif_asin_keywords",
+      "description": "Reverse-search one Amazon ASIN's SIF traffic keywords, ranks, traffic shares, and conversion markers through LinkFox.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "asin": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1000,
+            "description": "The single Amazon ASIN to analyze."
+          },
+          "country": {
+            "type": "string",
+            "enum": [
+              "US",
+              "UK",
+              "DE",
+              "CA",
+              "JP",
+              "FR",
+              "ES",
+              "IT",
+              "MX",
+              "AU",
+              "AE",
+              "BR",
+              "SA"
+            ],
+            "description": "The Amazon marketplace code. LinkFox defaults to US when omitted."
+          },
+          "keyword": {
+            "type": "string",
+            "maxLength": 1000,
+            "description": "An optional localized keyword used to filter the result."
+          },
+          "timePieceType": {
+            "type": "string",
+            "enum": [
+              "latelyDay",
+              "month",
+              "week"
+            ],
+            "description": "The analysis period type. LinkFox defaults to latelyDay."
+          },
+          "timePieceValue": {
+            "type": "string",
+            "maxLength": 1000,
+            "description": "The period value: 7 or 30 for latelyDay, YYYY-MM for month, or the week-start date in YYYY-MM-DD format."
+          },
+          "conditions": {
+            "type": "string",
+            "maxLength": 1000,
+            "description": "Comma-separated SIF keyword filters, including traffic-position, advertising, conversion, stability, and period-entry markers."
+          },
+          "sortBy": {
+            "type": "string",
+            "enum": [
+              "lastRank",
+              "adLastRank",
+              "updateTime",
+              "searchesRank",
+              "estSearchesNum"
+            ],
+            "description": "The keyword sort field. Omit it to use SIF's system order."
+          },
+          "desc": {
+            "type": "boolean",
+            "description": "Whether to sort descending. LinkFox defaults to true."
+          },
+          "pageNum": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based result page. LinkFox defaults to 1."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 10,
+            "maximum": 100,
+            "description": "The number of keyword records per page. LinkFox defaults to 100."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "asin"
+        ],
+        "description": "Parameters for reverse-searching one ASIN's SIF keywords."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "The SIF business code; 1 indicates success."
+          },
+          "msg": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The SIF response message."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The number of records returned by this request."
+          },
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A SIF keyword record with ranks, search volume, traffic shares, exposure scores, placements, and conversion markers."
+            },
+            "description": "The SIF records returned by this request."
+          },
+          "columns": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A provider-defined rendering-column definition."
+            },
+            "description": "The LinkFox rendering-column definitions."
+          },
+          "type": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The LinkFox rendering style when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "title": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The result title when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "costTime": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "description": "The upstream processing time in milliseconds."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "costToken": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The LinkFox token cost when provided."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "isParentAsin": {
+            "type": "boolean",
+            "description": "Whether the queried ASIN is a parent ASIN."
+          },
+          "hasVaiants": {
+            "type": "boolean",
+            "description": "Whether the queried product has variants."
+          },
+          "abaCreateDateWeek": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The latest week represented by the ABA data."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "code",
+          "msg",
+          "total",
+          "data",
+          "columns",
+          "type",
+          "title",
+          "costTime",
+          "costToken",
+          "abaCreateDateWeek"
+        ],
+        "description": "SIF keyword intelligence for one Amazon ASIN."
+      }
+    },
     {
       "id": "linkfox.list_sp_campaigns",
       "service": "linkfox",