greatsumini/naver-finance-crawl-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

5 stars 5 forks 品質 70 トレンド 13MIT

Repository Install

MCP (Model Context Protocol) server for crawling Korean stock market data from Naver Finance.

概要

MCP (Model Context Protocol) server for crawling Korean stock market data from Naver Finance. A Node.js-based web crawler built with TypeScript, Axios, and Cheerio, with MCP server support for AI assistants. - : Fetch the most searched stocks from Naver Finance with real-time data - : Get comprehensive stock information by 6-digit stock code - : Full integration with AI assistants via Model Context Protocol - : Flexible transport options for different use cases - : Proper handling of Korean characters (EUC-KR) - : Fully typed with strict mode enabled - : Extensible base crawler class for custom implementations - : Cheerio-based HTML parsing with helper utilities - : Axios-based HTTP client with retry logic - : Vitest with unit, integration, and E2E tests - : ESLint and Prettier for code consistency To install Naver Finance Crawl MCP Server for any client automatically via Smithery: Available clients: cursor, claude, vscode, windsurf, cline, zed, etc.

README

以下は原文 README の抜粋です。原文を見る。

Naver Finance Crawl MCP

MCP (Model Context Protocol) server for crawling Korean stock market data from Naver Finance.

A Node.js-based web crawler built with TypeScript, Axios, and Cheerio, with MCP server support for AI assistants.

Features

crawl-top-stocks: Fetch the most searched stocks from Naver Finance with real-time data
crawl-stock-detail: Get comprehensive stock information by 6-digit stock code
MCP Server Support: Full integration with AI assistants via Model Context Protocol
HTTP & STDIO Transports: Flexible transport options for different use cases
Korean Encoding Support: Proper handling of Korean characters (EUC-KR)
TypeScript Support: Fully typed with strict mode enabled
Modular Architecture: Extensible base crawler class for custom implementations
HTML Parsing: Cheerio-based HTML parsing with helper utilities
HTTP Requests: Axios-based HTTP client with retry logic
Testing: Vitest with unit, integration, and E2E tests
Code Quality: ESLint and Prettier for code consistency

Project Structure

src/
├── crawlers/           # Crawler implementations
│   ├── baseCrawler.ts  # Base class for all crawlers
│   ├── exampleCrawler.ts # Example crawler implementation
│   └── index.ts
├── utils/              # Utility functions
│   ├── request.ts      # HTTP client with retry logic
│   ├── parser.ts       # HTML parsing helper
│   └── index.ts
├── types/              # TypeScript type definitions
│   └── index.ts
└── index.ts            # Main entry point

tests/
├── unit/               # Unit tests
├── integration/        # Integration tests
└── e2e/                # E2E tests

Installation

NPM

npm install -g naver-finance-crawl-mcp

Smithery

To install Naver Finance Crawl MCP Server for any client automatically via Smithery:

npx -y @smithery/cli@latest install naver-finance-crawl-mcp --client

Available clients: cursor, claude, vscode, windsurf, cline, zed, etc.

Example for Cursor:

npx -y @smithery/cli@latest install naver-finance-crawl-mcp --client cursor

This will automatically configure the MCP server in your chosen client.

Development Setup

pnpm install

MCP Client Integration

Naver Finance Crawl MCP can be integrated with various AI coding assistants and IDEs that support the Model Context Protocol (MCP).

Requirements

Node.js >= v18.0.0

GitHub で README 全文を見る

インストール

npx -y naver-finance-crawl-mcp

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "naver-finance": {
      "command": "npx",
      "args": ["-y", "naver-finance-crawl-mcp"]
    }
  }
}