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"]
    }
  }
}