@oomol-lab/open-connector 1.9.0 → 1.9.1

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

@@ -0,0 +1,1162 @@
+{
+  "service": "ftshare",
+  "displayName": "FTShare",
+  "homepageUrl": "https://ftai.chat/ftshare",
+  "categories": [
+    "Data & Analytics"
+  ],
+  "authTypes": [
+    "api_key"
+  ],
+  "auth": [
+    {
+      "type": "api_key",
+      "label": "API Key",
+      "placeholder": "YOUR_API_KEY",
+      "description": "Sign in to FTShare and obtain your API key at https://ftai.chat/me/profile. Available datasets and request quotas depend on your subscription."
+    }
+  ],
+  "actions": [
+    {
+      "id": "ftshare.get_balance_sheets",
+      "service": "ftshare",
+      "name": "get_balance_sheets",
+      "description": "Read A-share balance sheets for one stock's full history or one market-wide report period.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "stock_code": {
+            "type": "string",
+            "description": "Six-digit A-share code with exchange suffix, for example 000001.SZ. Returns all historical periods without pagination.",
+            "pattern": "^[0-9]{6}\\.[A-Z]+$"
+          },
+          "year": {
+            "type": "integer",
+            "description": "Report year, required for market-wide queries."
+          },
+          "report_type": {
+            "type": "string",
+            "enum": [
+              "q1",
+              "q2",
+              "q3",
+              "annual",
+              "h1"
+            ],
+            "description": "Report period: q1, q2 (half-year), q3, or annual. Income and balance sheets also accept h1 as q2."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Market query page, starting at 1; defaults to 1."
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 500,
+            "description": "Market query page size; defaults to 50, maximum 500."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Choose either one stock's full history or a paginated market report period.",
+        "oneOf": [
+          {
+            "required": [
+              "stock_code"
+            ],
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "year"
+                  ]
+                },
+                {
+                  "required": [
+                    "report_type"
+                  ]
+                },
+                {
+                  "required": [
+                    "page"
+                  ]
+                },
+                {
+                  "required": [
+                    "page_size"
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "required": [
+              "year",
+              "report_type"
+            ],
+            "not": {
+              "required": [
+                "stock_code"
+              ]
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "description": "Upstream status code; 200 indicates success."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream status message."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "items": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "stock_code": {
+                      "type": "string",
+                      "description": "Stock code returned by FTShare."
+                    },
+                    "stock_name": {
+                      "type": "string",
+                      "description": "Stock name."
+                    },
+                    "year": {
+                      "type": "integer",
+                      "description": "Report year."
+                    },
+                    "report_type": {
+                      "type": "string",
+                      "description": "Report period type."
+                    },
+                    "report_type_cn": {
+                      "type": "string",
+                      "description": "Chinese report period name."
+                    },
+                    "publish_date": {
+                      "type": "string",
+                      "description": "Publication date in YYYY-MM-DD format."
+                    },
+                    "report_form_type": {
+                      "type": "string",
+                      "description": "Statement consolidation and adjustment type."
+                    },
+                    "t_assets": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Total assets."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Total assets."
+                    },
+                    "t_liability": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Total liabilities."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Total liabilities."
+                    },
+                    "t_equity": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Total equity."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Total equity."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "One report record with provider-defined financial fields."
+                },
+                "description": "Records, retaining financial strings, nulls, and additional upstream fields."
+              },
+              "total_items": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "total_pages": {
+                "type": "integer",
+                "description": "Total result pages."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Report records and pagination totals."
+          }
+        },
+        "additionalProperties": true,
+        "description": "FTShare response envelope; upstream extension fields are preserved."
+      }
+    },
+    {
+      "id": "ftshare.get_cashflow_statements",
+      "service": "ftshare",
+      "name": "get_cashflow_statements",
+      "description": "Read A-share cash flow statements for one stock's full history or one market-wide report period.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "stock_code": {
+            "type": "string",
+            "description": "Six-digit A-share code with exchange suffix, for example 000001.SZ. Returns all historical periods without pagination.",
+            "pattern": "^[0-9]{6}\\.[A-Z]+$"
+          },
+          "year": {
+            "type": "integer",
+            "description": "Report year, required for market-wide queries."
+          },
+          "report_type": {
+            "type": "string",
+            "enum": [
+              "q1",
+              "q2",
+              "q3",
+              "annual"
+            ],
+            "description": "Report period: q1, q2 (half-year), q3, or annual. Income and balance sheets also accept h1 as q2."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Market query page, starting at 1; defaults to 1."
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 500,
+            "description": "Market query page size; defaults to 50, maximum 500."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Choose either one stock's full history or a paginated market report period.",
+        "oneOf": [
+          {
+            "required": [
+              "stock_code"
+            ],
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "year"
+                  ]
+                },
+                {
+                  "required": [
+                    "report_type"
+                  ]
+                },
+                {
+                  "required": [
+                    "page"
+                  ]
+                },
+                {
+                  "required": [
+                    "page_size"
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "required": [
+              "year",
+              "report_type"
+            ],
+            "not": {
+              "required": [
+                "stock_code"
+              ]
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "description": "Upstream status code; 200 indicates success."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream status message."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "items": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "stock_code": {
+                      "type": "string",
+                      "description": "Stock code returned by FTShare."
+                    },
+                    "stock_name": {
+                      "type": "string",
+                      "description": "Stock name."
+                    },
+                    "year": {
+                      "type": "integer",
+                      "description": "Report year."
+                    },
+                    "report_type": {
+                      "type": "string",
+                      "description": "Report period type."
+                    },
+                    "report_type_cn": {
+                      "type": "string",
+                      "description": "Chinese report period name."
+                    },
+                    "publish_date": {
+                      "type": "string",
+                      "description": "Publication date in YYYY-MM-DD format."
+                    },
+                    "detail_report_type": {
+                      "type": "string",
+                      "description": "Detailed statement consolidation and adjustment type."
+                    },
+                    "net_oper_cash_flow": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Net cash flow from operating activities."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Net cash flow from operating activities."
+                    },
+                    "net_invest_cash_flow": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Net cash flow from investing activities."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Net cash flow from investing activities."
+                    },
+                    "net_fin_cash_flow": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Net cash flow from financing activities."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Net cash flow from financing activities."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "One report record with provider-defined financial fields."
+                },
+                "description": "Records, retaining financial strings, nulls, and additional upstream fields."
+              },
+              "total_items": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "total_pages": {
+                "type": "integer",
+                "description": "Total result pages."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Report records and pagination totals."
+          }
+        },
+        "additionalProperties": true,
+        "description": "FTShare response envelope; upstream extension fields are preserved."
+      }
+    },
+    {
+      "id": "ftshare.get_earnings_forecasts",
+      "service": "ftshare",
+      "name": "get_earnings_forecasts",
+      "description": "Read A-share earnings forecasts by stock or market report period, including forecast ranges and year-over-year changes.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "stock_code": {
+            "type": "string",
+            "description": "Six-digit A-share code with exchange suffix, for example 000001.SZ. Returns all historical periods without pagination.",
+            "pattern": "^[0-9]{6}\\.[A-Z]+$"
+          },
+          "year": {
+            "type": "integer",
+            "description": "Report year, required for market-wide queries."
+          },
+          "report_type": {
+            "type": "string",
+            "enum": [
+              "q1",
+              "q2",
+              "q3",
+              "annual"
+            ],
+            "description": "Report period: q1, q2 (half-year), q3, or annual. Income and balance sheets also accept h1 as q2."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Market query page, starting at 1; defaults to 1."
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 500,
+            "description": "Market query page size; defaults to 50, maximum 500."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Choose either one stock's full history or a paginated market report period.",
+        "oneOf": [
+          {
+            "required": [
+              "stock_code"
+            ],
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "year"
+                  ]
+                },
+                {
+                  "required": [
+                    "report_type"
+                  ]
+                },
+                {
+                  "required": [
+                    "page"
+                  ]
+                },
+                {
+                  "required": [
+                    "page_size"
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "required": [
+              "year",
+              "report_type"
+            ],
+            "not": {
+              "required": [
+                "stock_code"
+              ]
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "description": "Upstream status code; 200 indicates success."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream status message."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "items": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "stock_code": {
+                      "type": "string",
+                      "description": "Stock code returned by FTShare."
+                    },
+                    "stock_name": {
+                      "type": "string",
+                      "description": "Stock name."
+                    },
+                    "year": {
+                      "type": "integer",
+                      "description": "Report year."
+                    },
+                    "report_type": {
+                      "type": "string",
+                      "description": "Report period type."
+                    },
+                    "report_type_cn": {
+                      "type": "string",
+                      "description": "Chinese report period name."
+                    },
+                    "publish_date": {
+                      "type": "string",
+                      "description": "Publication date in YYYY-MM-DD format."
+                    },
+                    "forecast_subject": {
+                      "type": "string",
+                      "description": "Forecast financial metric."
+                    },
+                    "forecast_type": {
+                      "type": "string",
+                      "description": "Forecast category reported by FTShare."
+                    },
+                    "forecast_value_min": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Lower forecast value."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Lower forecast value."
+                    },
+                    "forecast_value_max": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Upper forecast value."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Upper forecast value."
+                    },
+                    "unit": {
+                      "type": "string",
+                      "description": "Forecast value unit."
+                    },
+                    "yoy_change_min": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Lower year-over-year percentage change."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Lower year-over-year percentage change."
+                    },
+                    "yoy_change_max": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Upper year-over-year percentage change."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Upper year-over-year percentage change."
+                    },
+                    "last_year_value": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Value for the same period last year."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Value for the same period last year."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "One report record with provider-defined financial fields."
+                },
+                "description": "Records, retaining financial strings, nulls, and additional upstream fields."
+              },
+              "total_items": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "total_pages": {
+                "type": "integer",
+                "description": "Total result pages."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Report records and pagination totals."
+          }
+        },
+        "additionalProperties": true,
+        "description": "FTShare response envelope; upstream extension fields are preserved."
+      }
+    },
+    {
+      "id": "ftshare.get_earnings_reports",
+      "service": "ftshare",
+      "name": "get_earnings_reports",
+      "description": "Read A-share earnings express reports by stock or market report period, preserving multiple disclosures and corrections.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "stock_code": {
+            "type": "string",
+            "description": "Six-digit A-share code with exchange suffix, for example 000001.SZ. Returns all historical periods without pagination.",
+            "pattern": "^[0-9]{6}\\.[A-Z]+$"
+          },
+          "year": {
+            "type": "integer",
+            "description": "Report year, required for market-wide queries."
+          },
+          "report_type": {
+            "type": "string",
+            "enum": [
+              "q1",
+              "q2",
+              "q3",
+              "annual"
+            ],
+            "description": "Report period: q1, q2 (half-year), q3, or annual. Income and balance sheets also accept h1 as q2."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Market query page, starting at 1; defaults to 1."
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 500,
+            "description": "Market query page size; defaults to 50, maximum 500."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Choose either one stock's full history or a paginated market report period.",
+        "oneOf": [
+          {
+            "required": [
+              "stock_code"
+            ],
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "year"
+                  ]
+                },
+                {
+                  "required": [
+                    "report_type"
+                  ]
+                },
+                {
+                  "required": [
+                    "page"
+                  ]
+                },
+                {
+                  "required": [
+                    "page_size"
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "required": [
+              "year",
+              "report_type"
+            ],
+            "not": {
+              "required": [
+                "stock_code"
+              ]
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "description": "Upstream status code; 200 indicates success."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream status message."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "items": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "stock_code": {
+                      "type": "string",
+                      "description": "Stock code returned by FTShare."
+                    },
+                    "stock_name": {
+                      "type": "string",
+                      "description": "Stock name."
+                    },
+                    "year": {
+                      "type": "integer",
+                      "description": "Report year."
+                    },
+                    "report_type": {
+                      "type": "string",
+                      "description": "Report period type."
+                    },
+                    "report_type_cn": {
+                      "type": "string",
+                      "description": "Chinese report period name."
+                    },
+                    "publish_date": {
+                      "type": "string",
+                      "description": "Publication date in YYYY-MM-DD format."
+                    },
+                    "eps": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Earnings per share."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Earnings per share."
+                    },
+                    "total_revenue": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Total revenue."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Total revenue."
+                    },
+                    "net_profit": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Net profit."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Net profit."
+                    },
+                    "roe": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Return on equity."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Return on equity."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "One report record with provider-defined financial fields."
+                },
+                "description": "Records, retaining financial strings, nulls, and additional upstream fields."
+              },
+              "total_items": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "total_pages": {
+                "type": "integer",
+                "description": "Total result pages."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Report records and pagination totals."
+          }
+        },
+        "additionalProperties": true,
+        "description": "FTShare response envelope; upstream extension fields are preserved."
+      }
+    },
+    {
+      "id": "ftshare.get_income_statements",
+      "service": "ftshare",
+      "name": "get_income_statements",
+      "description": "Read A-share income statements for one stock's full history or one market-wide report period.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "stock_code": {
+            "type": "string",
+            "description": "Six-digit A-share code with exchange suffix, for example 000001.SZ. Returns all historical periods without pagination.",
+            "pattern": "^[0-9]{6}\\.[A-Z]+$"
+          },
+          "year": {
+            "type": "integer",
+            "description": "Report year, required for market-wide queries."
+          },
+          "report_type": {
+            "type": "string",
+            "enum": [
+              "q1",
+              "q2",
+              "q3",
+              "annual",
+              "h1"
+            ],
+            "description": "Report period: q1, q2 (half-year), q3, or annual. Income and balance sheets also accept h1 as q2."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Market query page, starting at 1; defaults to 1."
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 500,
+            "description": "Market query page size; defaults to 50, maximum 500."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Choose either one stock's full history or a paginated market report period.",
+        "oneOf": [
+          {
+            "required": [
+              "stock_code"
+            ],
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "year"
+                  ]
+                },
+                {
+                  "required": [
+                    "report_type"
+                  ]
+                },
+                {
+                  "required": [
+                    "page"
+                  ]
+                },
+                {
+                  "required": [
+                    "page_size"
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "required": [
+              "year",
+              "report_type"
+            ],
+            "not": {
+              "required": [
+                "stock_code"
+              ]
+            }
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "description": "Upstream status code; 200 indicates success."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream status message."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "items": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "stock_code": {
+                      "type": "string",
+                      "description": "Stock code returned by FTShare."
+                    },
+                    "stock_name": {
+                      "type": "string",
+                      "description": "Stock name."
+                    },
+                    "year": {
+                      "type": "integer",
+                      "description": "Report year."
+                    },
+                    "report_type": {
+                      "type": "string",
+                      "description": "Report period type."
+                    },
+                    "report_type_cn": {
+                      "type": "string",
+                      "description": "Chinese report period name."
+                    },
+                    "publish_date": {
+                      "type": "string",
+                      "description": "Publication date in YYYY-MM-DD format."
+                    },
+                    "report_form_type": {
+                      "type": "string",
+                      "description": "Statement consolidation and adjustment type."
+                    },
+                    "t_revenue": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Total revenue."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Total revenue."
+                    },
+                    "n_profit": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Net profit including minority interests."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Net profit including minority interests."
+                    },
+                    "parcomp_n_profit": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Net profit attributable to the parent company."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Net profit attributable to the parent company."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "One report record with provider-defined financial fields."
+                },
+                "description": "Records, retaining financial strings, nulls, and additional upstream fields."
+              },
+              "total_items": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "total_pages": {
+                "type": "integer",
+                "description": "Total result pages."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Report records and pagination totals."
+          }
+        },
+        "additionalProperties": true,
+        "description": "FTShare response envelope; upstream extension fields are preserved."
+      }
+    },
+    {
+      "id": "ftshare.list_companies",
+      "service": "ftshare",
+      "name": "list_companies",
+      "description": "List company snapshots with optional exact stock name and unsuffixed stock code filters.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "stock_code": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Exact stock code without exchange suffix, for example 000001."
+          },
+          "stock_name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Exact stock name."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page number; defaults to 1."
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 200,
+            "description": "Page size; defaults to 50, maximum 200."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Company filters and pagination."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "integer",
+            "description": "Upstream status code; 200 indicates success."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream status message."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "pageNum": {
+                "type": "integer",
+                "description": "Current page number."
+              },
+              "pageSize": {
+                "type": "integer",
+                "description": "Current page size."
+              },
+              "total": {
+                "type": "integer",
+                "description": "Total matching companies."
+              },
+              "pages": {
+                "type": "integer",
+                "description": "Total result pages."
+              },
+              "records": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "stock_code": {
+                      "type": "string",
+                      "description": "Stock code returned by FTShare."
+                    },
+                    "stock_name": {
+                      "type": "string",
+                      "description": "Stock name."
+                    },
+                    "company_code": {
+                      "type": "string",
+                      "description": "Company code."
+                    },
+                    "main_business": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Main business activities."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Main business activities."
+                    },
+                    "company_profile": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Company profile."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Company profile."
+                    },
+                    "total_market_value": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Total market capitalization as reported by FTShare."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Total market capitalization as reported by FTShare."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Company details; additional upstream fields are preserved."
+                },
+                "description": "Company snapshots."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Company result page."
+          }
+        },
+        "additionalProperties": true,
+        "description": "FTShare response envelope; upstream extension fields are preserved."
+      }
+    }
+  ]
+}