@helloxiaohu/plugin-stock-market 0.0.2

package/README.md

@@ -0,0 +1,134 @@
+# @xpert-ai/plugin-stock-market
+
+Comprehensive stock market data plugin for A-shares, Hong Kong, and US markets.
+
+## Features
+
+- **Real-time Quotes**: Get current stock prices, volume, and market data
+- **K-line Charts**: Historical OHLCV data for technical analysis
+- **Technical Indicators**: MA, MACD, RSI, KDJ calculations
+- **Stock Search**: Search stocks by code or name
+- **Multi-market Support**: A-shares (SH/SZ), Hong Kong, and US markets
+
+## Installation
+
+```bash
+npm install @xpert-ai/plugin-stock-market
+```
+
+## Configuration
+
+```typescript
+{
+  source: 'sina' | 'tencent',  // Data source (default: 'sina')
+  timeout: 5000,                // Request timeout in ms
+  cacheEnabled: true,           // Enable data caching
+  cacheTTL: 300                 // Cache TTL in seconds
+}
+```
+
+## Tools
+
+### 1. stock_market_get_quote
+Get real-time stock quotes.
+
+**Parameters**:
+- `code` (string, required): Stock code (e.g., "600519", "00700", "AAPL")
+- `market` (enum, optional): Market type - "auto", "sh", "sz", "hk", "us" (default: "auto")
+
+**Example**:
+```typescript
+// Get quote for 茅台
+{ code: "600519" }
+
+// Get quote for Tencent (HK)
+{ code: "00700", market: "hk" }
+```
+
+### 2. stock_market_get_kline
+Get K-line (candlestick) data.
+
+**Parameters**:
+- `code` (string, required): Stock code
+- `period` (enum): "1d", "1w", "1m", "3m", "6m", "1y", "ytd"
+- `market` (enum, optional): Market type
+
+**Example**:
+```typescript
+{ code: "600519", period: "1m" }
+```
+
+### 3. stock_market_get_technical
+Get technical indicators.
+
+**Parameters**:
+- `code` (string, required): Stock code
+- `indicators` (array): List of indicators - "ma", "macd", "rsi", "kdj"
+- `period` (enum, optional): Time period for calculation
+
+**Example**:
+```typescript
+{ 
+  code: "600519", 
+  indicators: ["ma", "macd", "rsi"] 
+}
+```
+
+### 4. stock_market_search
+Search for stocks.
+
+**Parameters**:
+- `keyword` (string, required): Search keyword
+- `market` (enum, optional): Filter by market
+
+**Example**:
+```typescript
+{ keyword: "茅台" }
+{ keyword: "Apple" }
+```
+
+## Data Sources
+
+- **Primary**: Sina Finance (free, stable)
+- **Backup**: Tencent Finance
+- **HK/US**: Snowball / Yahoo Finance
+
+## Error Handling
+
+The plugin uses unified error codes:
+
+| Code | Description |
+|------|-------------|
+| 1001 | Invalid stock code format |
+| 2001 | Stock not found |
+| 2002 | No data available |
+| 3001 | API error |
+| 3003 | Rate limit exceeded |
+
+## Output Format
+
+### Text Format (default)
+```
+【贵州茅台(600519)】
+  当前价: 1690.00 元
+  涨跌额: +12.00 元
+  涨跌幅: +0.72%
+  ...
+```
+
+### JSON Format
+```json
+{
+  "success": true,
+  "data": {
+    "code": "600519",
+    "name": "贵州茅台",
+    "price": 1690.00,
+    ...
+  }
+}
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 股票行情工具集插件入口
+ */
+import type { XpertPlugin } from '@xpert-ai/plugin-sdk';
+import { z } from 'zod';
+declare const ConfigSchema: z.ZodObject<{
+    source: z.ZodDefault<z.ZodOptional<z.ZodEnum<["sina", "tencent"]>>>;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    cacheEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    cacheTTL: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    timeout?: number;
+    source?: "sina" | "tencent";
+    cacheEnabled?: boolean;
+    cacheTTL?: number;
+}, {
+    timeout?: number;
+    source?: "sina" | "tencent";
+    cacheEnabled?: boolean;
+    cacheTTL?: number;
+}>;
+declare const plugin: XpertPlugin<z.infer<typeof ConfigSchema>>;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAYvB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;EAKhB,CAAA;AAEF,QAAA,MAAM,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CA2BrD,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * 股票行情工具集插件入口
+ */
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { z } from 'zod';
+import { StockMarketPlugin } from './lib/stock-market.plugin.js';
+import { icon } from './lib/types.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
+const ConfigSchema = z.object({
+    source: z.enum(['sina', 'tencent']).optional().default('sina'),
+    timeout: z.number().optional().default(5000),
+    cacheEnabled: z.boolean().optional().default(true),
+    cacheTTL: z.number().optional().default(300)
+});
+const plugin = {
+    meta: {
+        name: packageJson.name,
+        version: packageJson.version,
+        category: 'tools',
+        icon: {
+            type: 'image',
+            value: icon
+        },
+        displayName: 'Stock Market',
+        description: 'Comprehensive stock market data including real-time quotes, K-line charts, technical indicators, and stock search for A-shares, Hong Kong, and US markets',
+        keywords: ['stock', 'market', 'quotes', 'kline', 'technical', 'A股', '港股', '美股'],
+        author: 'XpertAI Team',
+    },
+    config: {
+        schema: ConfigSchema,
+    },
+    register(ctx) {
+        ctx.logger.log('register stock-market plugin');
+        return { module: StockMarketPlugin, global: true };
+    },
+    async onStart(ctx) {
+        ctx.logger.log('stock-market plugin started');
+    },
+    async onStop(ctx) {
+        ctx.logger.log('stock-market plugin stopped');
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAErC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACjD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAErC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAGtF,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC5C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CAC7C,CAAC,CAAA;AAEF,MAAM,MAAM,GAA8C;IACxD,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,IAAI;SACZ;QACD,WAAW,EAAE,cAAc;QAC3B,WAAW,EAAE,2JAA2J;QACxK,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAC/E,MAAM,EAAE,cAAc;KACvB;IACD,MAAM,EAAE;QACN,MAAM,EAAE,YAAY;KACrB;IACD,QAAQ,CAAC,GAAG;QACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAA;QAC9C,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IACpD,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,GAAG;QACf,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;IAC/C,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,GAAG;QACd,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;IAC/C,CAAC;CACF,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/lib/market-client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 股票市场数据客户端
+ * 支持新浪财经 (A股、港股) 和腾讯财经 (美股)
+ */
+import { MarketType, StockQuote, KlineData, KlinePoint, StockSearchResult, MoneyFlow } from './types.js';
+export declare function detectMarket(code: string): MarketType;
+export declare function formatCodeForSina(code: string, market?: MarketType): string;
+export declare function normalizeCode(code: string, market?: MarketType): string;
+export declare function fetchRealtimeQuotes(codes: string[]): Promise<Map<string, StockQuote>>;
+export declare function fetchKlineData(code: string, period?: 'day' | 'week' | 'month', count?: number): Promise<KlineData | null>;
+export declare function calculateMA(data: KlinePoint[], periods: number[]): {
+    [period: string]: number;
+};
+export declare function calculateMACD(data: KlinePoint[]): {
+    dif: number;
+    dea: number;
+    macd: number;
+} | null;
+export declare function calculateRSI(data: KlinePoint[], period?: number): number | null;
+export declare function calculateKDJ(data: KlinePoint[]): {
+    k: number;
+    d: number;
+    j: number;
+} | null;
+export declare function searchStock(keyword: string): Promise<StockSearchResult[]>;
+export declare function fetchMoneyFlow(code: string): Promise<MoneyFlow | null>;
+//# sourceMappingURL=market-client.d.ts.map

package/dist/lib/market-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-client.d.ts","sourceRoot":"","sources":["../../src/lib/market-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AA8DxG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAoBrD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAc3E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAYvE;AA0GD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAqB3F;AAuED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,OAAe,EACxC,KAAK,GAAE,MAAY,GAClB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAiD3B;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG;IAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAY/F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6BnG;AAeD,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,GAAG,IAAI,CAsBnF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmB3F;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA8C/E;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAqC5E"}