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