open-index/open-npm huggingface dataset:
npm package: @helloxiaohu/plugin-stock-market
Description: Comprehensive stock market data plugin for A-shares, Hong Kong, and US markets.
Latest version: 0.0.3

# @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
npm package: @helloxiaohu/plugin-stock-news
Description: 股票新闻工具集插件 - 获取A股和港股新闻、公告和新闻时间线
Latest version: 0.0.2

# @xpert-ai/plugin-stock-news

股票新闻工具集插件 - 获取A股和港股新闻、公告和新闻时间线

## 功能概述

本插件提供以下核心功能：

- **新闻查询**: 获取股票相关新闻，支持来源去重和时间标准化
- **公告查询**: 获取公司公告信息
- **新闻时间线**: 按时间线展示新闻和公告

## 工具列表

### stock_news_latest

获取股票最新新闻

**参数**:
- `codes` (string[]): 股票代码列表，如 ['600519', '000001']
- `maxItems` (number, 可选): 最大返回条数，默认20
- `timeWindow` (number, 可选): 时间窗口（天），默认7

**返回**:
```json
{
  "news": [
    {
      "title": "新闻标题",
      "summary": "新闻摘要",
      "source": "新浪财经",
      "publishTime": "2026-03-02 10:30:00",
      "url": "https://...",
      "sentiment": "positive",
      "relevance": 0.95
    }
  ]
}
```

### stock_announcements

获取股票公告列表

**参数**:
- `code` (string): 股票代码
- `type` (string, 可选): 公告类型，如 '业绩预告', '重大事项'
- `maxItems` (number, 可选): 最大返回条数，默认10

**返回**:
```json
{
  "announcements": [
    {
      "code": "600519",
      "title": "公告标题",
      "type": "业绩预告",
      "publishTime": "2026-03-02",
      "url": "https://...",
      "summary": "公告摘要"
    }
  ]
}
```

### stock_news_timeline

获取股票新闻时间线

**参数**:
- `code` (string): 股票代码
- `startDate` (string, 可选): 开始日期，格式 YYYY-MM-DD
- `endDate` (string, 可选): 结束日期，格式 YYYY-MM-DD

**返回**:
```json
{
  "code": "600519",
  "date": "2026-03-02",
  "news": [...],
  "announcements": [...]
}
```

## 配置说明

插件支持以下配置项：

| 配置项 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| source | string | 'sina' | 数据源，可选 sina/eastmoney/tencent |
| maxItems | number | 20 | 默认最大返回条数 |
| timeWindow | number | 7 | 默认时间窗口（天） |

## 安装使用

```bash
# 编译插件
cd xpert-plugins/xpertai
corepack pnpm -C tools/stock-news exec tsc -p tsconfig.lib.json

# 安装到平台
curl -X POST http://127.0.0.1:3000/api/plugin \
  -H "Authorization: Bearer <token>" \
  -H "tenant-id: <tenant-id>" \
  -H "organization-id: <organization-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "pluginName":"@xpert-ai/plugin-stock-news",
    "source":"code",
    "workspacePath":"/path/to/xpert-plugins/xpertai/tools/stock-news"
  }'
```

## 数据来源

- 新浪财经 (sina)
- 东方财富 (eastmoney)
- 腾讯财经 (tencent)

## 注意事项

1. 免费接口有访问频率限制，建议合理设置缓存
2. 不同数据源的返回格式可能略有差异
3. 新闻数据仅供参考，不构成投资建议
npm package: @helloxiaohu/plugin-stock-screener
Description: 股票筛选插件 - 根据条件筛选股票
Latest version: 0.0.2

# @xpert-ai/plugin-stock-screener

股票筛选插件 - 根据条件筛选股票

## 功能

- 按市值筛选
- 按行业筛选
- 按财务指标筛选
- 按技术指标筛选

## 配置

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| source | string | 'eastmoney' | 数据源 |
| maxItems | number | 50 | 最大返回条数 |
| timeout | number | 5000 | 请求超时时间(毫秒) |

## 工具列表

- `stock_screen_by_market_cap` - 按市值筛选股票
- `stock_screen_by_industry` - 按行业筛选股票
- `stock_screen_by_metrics` - 按财务/技术指标筛选股票

## 使用示例

```typescript
// 按市值筛选
{
  "tool": "stock_screen_by_market_cap",
  "input": {
    "market": "SH",
    "minCap": 1000000000,
    "maxCap": 10000000000
  }
}

// 按行业筛选
{
  "tool": "stock_screen_by_industry",
  "input": {
    "industry": "电子",
    "maxItems": 20
  }
}
```
npm package: @helloxiaohu/plugin-stock-sector
Description: 行业板块插件 - 提供A股行业板块、概念板块、地域板块的行情数据、成分股和排名功能
Latest version: 0.0.2

# @xpert-ai/plugin-stock-sector

行业板块插件 - 提供A股行业板块、概念板块、地域板块的行情数据、成分股和排名功能

## 功能特性

- ✅ 板块行情查询（行业/概念/地域）
- ✅ 板块成分股列表
- ✅ 板块涨跌幅排名
- ✅ 支持A股市场

## 安装

```bash
npm install @xpert-ai/plugin-stock-sector
```

## 配置

```typescript
{
  source: 'eastmoney' | 'sina',  // 数据源（默认：eastmoney）
  timeout: 5000                   // 请求超时时间（毫秒，默认：5000）
}
```

## 工具说明

### 1. sector_quotes

获取板块实时行情数据

**参数**:
- `type`: 板块类型
  - `industry`: 行业板块
  - `concept`: 概念板块
  - `region`: 地域板块
- `market`: 市场筛选（可选）
  - `SH`: 上海
  - `SZ`: 深圳
  - `HK`: 香港

**示例**:
```typescript
{
  type: 'industry'
}
```

**返回**:
```json
[
  {
    "code": "BK0001",
    "name": "钢铁行业",
    "type": "industry",
    "change": 0.5,
    "changePercent": 1.23,
    "volume": 1234567,
    "amount": 9876543,
    "leadingStock": {
      "code": "600019",
      "name": "宝钢股份",
      "changePercent": 5.2
    }
  }
]
```

### 2. sector_constituents

获取板块成分股列表

**参数**:
- `sectorCode`: 板块代码
- `limit`: 返回数量限制（默认：20，最大：100）

**示例**:
```typescript
{
  sectorCode: 'BK0001',
  limit: 30
}
```

**返回**:
```json
[
  {
    "code": "600019",
    "name": "宝钢股份",
    "market": "SH",
    "weight": 0.15,
    "changePercent": 5.2
  }
]
```

### 3. sector_ranking

获取板块涨跌幅排名

**参数**:
- `type`: 板块类型
- `sortBy`: 排序字段（默认：changePercent）
  - `changePercent`: 按涨跌幅排序
  - `turnover`: 按成交额排序
- `limit`: 返回数量（默认：10，最大：50）

**示例**:
```typescript
{
  type: 'concept',
  sortBy: 'changePercent',
  limit: 10
}
```

**返回**:
```json
[
  {
    "rank": 1,
    "code": "BK0051",
    "name": "新能源",
    "type": "concept",
    "changePercent": 5.8,
    "turnover": 123456789
  }
]
```

## 数据源

- **东方财富**: 提供完整的板块数据（默认）
- **新浪财经**: 备用数据源

## 开发

```bash
# 编译
pnpm exec tsc -p tsconfig.lib.json

# 测试
pnpm exec jest -c jest.config.ts --runInBand
```

## 许可证

MIT