Stocksense

StockSense

一款 MCP（模型上下文协议）服务，可让 AI Agent 访问金融数据，包括 SEC EDGAR 文件、市场基本面、内幕交易和价格历史。无需 API 密钥。

快速开始

1. 安装

pip install stocksense

2. 添加到 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stocksense": {
      "command": "stocksense"
    }
  }
}

3. 重启 Claude Desktop

退出并重新打开 Claude Desktop。你应该会看到锤子图标，表示有 13 个工具可用。

可用工具

工具	说明
price_history	获取任意股票代码的历史 OHLCV 价格数据
quote	获取当前价格、市值、市盈率和 52 周价格区间
search_filings	搜索 SEC EDGAR 文件（10-K、10-Q、8-K）
get_filing	获取指定 SEC 文件的全文
insider_trades	获取 Form 4 文件中的近期内幕买入／卖出记录
financials	获取损益表、资产负债表、现金流量表和关键比率
analyze_company	汇总所有数据来源，生成全面的研究简报
compare_companies	并排比较多家公司的关键指标
earnings	获取季度盈利历史，包括 EPS 预估值与实际值
company_profile	公司简介：行业板块、行业和业务描述
dividends	获取股息历史和当前收益率
key_events	获取即将到来的财报日期、除息日和预估值
technicals	技术指标：SMA、EMA、RSI、MACD 和表现

示例查询

• “AAPL 过去一个月的价格历史是什么？”
• “给我一份 MSFT 的报价”
• “显示 TSLA 过去一年的周价格”
• “显示 Apple 最近的 10-K 文件”
• “Tesla 最近发生了哪些内幕交易？”
• “显示 Apple 的财务报表”
• “给我一份 Tesla 的研究简报”
• “比较 AAPL、MSFT 和 GOOGL”
• “显示 Apple 的盈利历史”
• “NVIDIA 属于哪个行业板块？”
• “显示 AAPL 的股息历史”
• “Microsoft 下一次财报发布日期是什么时候？”
• “Tesla 的技术指标有哪些？”

数据来源

• yfinance — 价格数据、报价、财务报表和分析师共识
• SEC EDGAR — 免费、无限量的文件和内幕交易数据（无需 API 密钥）

要求

• Python 3.11+
• 无需 API 密钥 — 使用免费的公开数据来源

开发

# Clone and install for development
git clone https://github.com/mikejj-creation/stocksense.git
cd stocksense
pip install -e ".[dev]"

# Run tests
pytest

# Run linter
ruff check src/ tests/

免责声明

StockSense 使用来自 Yahoo Finance 和 SEC EDGAR 的免费公开数据。用户有责任遵守各提供方的服务条款。本工具仅供参考，不构成财务建议。

许可证

MIT