Yfinance MCP Ts

A TypeScript wrapper for the Yahoo Finance API with a built-in MCP server for AI agents like Claude.

特性

• 20个MCP工具 --股票报价、财务、期权、筛选器、研究和市场数据
• LLM优化输出 --具有自动聚合和大小保护的紧凑文本/markdown响应
• 浏览器模拟 --通过以下方式绕过TLS指纹识别 impit 100%成功率
• 代理旋转 --具有自动故障跟踪和冷却功能的循环旋转
• 使用回退重试 --速率限制和瞬态误差的抖动指数退避
• 300+筛选器 --预定义的股票筛选器（日内上涨股、最活跃股、成长股等）
• 高级支持 --通过Puppeteer进行可选的Yahoo Finance Premium身份验证

安装

npm install yfinance-mcp-ts

MCP服务器设置

克劳德桌面/克劳德代码

添加到您的配置(~/.config/claude/claude_desktop_config.json 在macOS/Linux上， %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "yfinance": {
      "command": "npx",
      "args": ["yfinance-mcp-ts"]
    }
  }
}

使用代理轮换：

{
  "mcpServers": {
    "yfinance": {
      "command": "npx",
      "args": ["yfinance-mcp-ts"],
      "env": {
        "YFINANCE_PROXY_LIST": "http://user:pass@proxy1.com:8080\nhttp://user:pass@proxy2.com:8080"
      }
    }
  }
}

您还可以手动运行服务器：

npm run mcp          # production
npm run mcp:dev      # development (ts-node)
npx yfinance-mcp-ts  # from npm

可用工具

默认情况下，所有工具都返回压缩文本。添加 format: "json" 任何对原始JSON输出的调用。

环境变量

图书馆使用情况

股票行情自动收录器

import { Ticker } from 'yfinance-mcp-ts';

const ticker = new Ticker('AAPL');
// or multiple: new Ticker('AAPL MSFT GOOG') / new Ticker(['AAPL', 'MSFT'])

await ticker.getPrice();
await ticker.getSummaryDetail();
await ticker.getSummaryProfile();
await ticker.getKeyStats();
await ticker.getEarnings();
await ticker.getRecommendationTrend();

// Historical data
await ticker.getHistory({ period: '1mo', interval: '1d' });
await ticker.getHistory({ start: '2024-01-01', end: '2024-12-31', interval: '1wk' });

// Financial statements ('a' = annual, 'q' = quarterly)
await ticker.getIncomeStatement('a');
await ticker.getBalanceSheet('q');
await ticker.getCashFlow('a');
await ticker.getFinancials('income', 'a'); // type: 'income' | 'balance' | 'cash' | 'cashflow'

// Options
await ticker.getOptionChain();

// All available modules at once
await ticker.getAllModules();

All Ticker methods

特定基金： getFundHoldingInfo(), getFundTopHoldings(), getFundSectorWeightings(), getFundBondHoldings(), getFundEquityHoldings(), getFundBondRatings(), getFundPerformance(), getFundProfile()

筛选器

import { Screener } from 'yfinance-mcp-ts';

const screener = new Screener();
screener.availableScreeners;                    // list all 300+ screener IDs
screener.getScreenerInfo('day_gainers');         // screener metadata
await screener.getScreeners('day_gainers', 25); // run with result count
await screener.getScreeners('day_gainers most_actives', 10); // multiple

研究

import { Research } from 'yfinance-mcp-ts';

const research = new Research();
await research.getEarnings('2024-01-01', '2024-01-31');
await research.getSplits('2024-01-01', '2024-12-31');
await research.getIPOs('2024-01-01', '2024-12-31');

// Premium only
await research.getReports(100, { sector: 'Technology', investment_rating: 'Bullish' });
await research.getTrades(100, { trend: 'Bullish', term: 'Short term' });

独立功能

import { search, getMarketSummary, getTrending, getCurrencies, getValidCountries } from 'yfinance-mcp-ts';

await search('Apple', { quotesCount: 10, newsCount: 5 });
await search('AAPL', { firstQuote: true });
await getMarketSummary('united states');
await getTrending('united states');
await getCurrencies();
getValidCountries(); // ['united states', 'france', 'germany', ...]

配置

const ticker = new Ticker('AAPL', {
  country: 'united states',   // 14 supported countries
  timeout: 30000,
  httpClient: 'impit',        // 'impit' (default) or 'axios'
  retry: {
    enabled: true,
    maxRetries: 3,
    initialDelay: 1000,
    maxDelay: 30000,
  },
  proxyRotation: {
    proxyList: 'http://proxy1:8080\nhttp://proxy2:8080',
    maxFailures: 3,
    cooldownMs: 300000,
  },
  // Premium auth (requires puppeteer)
  username: 'your@email.com',
  password: 'password',
});

支持的国家： united states, australia, canada, france, germany, hong kong, india, italy, spain, united kingdom, brazil, new zealand, singapore, taiwan

需求

• Node.js>=20.0.0
• TypeScript>=5.0（用于开发）
• puppeteer >=21.0.0（可选，用于高级功能）
• https-proxy-agent / socks-proxy-agent （可选，用于代理支持）

许可证

麻省理工学院

学分

TypeScript端口 yahooquery 道格·格思里著。

免责声明

不隶属于雅虎股份有限公司数据仅供个人使用。在投入生产之前，请先查看雅虎的服务条款。