danggn-mcp
Provides proxy support for scraping Daangn listings using the Zyte API to avoid IP blocking.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@danggn-mcp search for used iPhone 14 in Gangnam"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
⚠️ Important Notices
이 프로젝트는당근마켓 공식 Open API가 아닌 공개 웹 페이지를 파싱합니다. 사이트 구조가 바뀌면 일부 기능이 깨질 수 있습니다. 개인·비상업적 용도를 권장합니다.
과도한 요청은 당근마켓에서 차단될 수 있습니다. 차단이 잦으면ZYTE_API_KEY 환경 변수로 Zyte 프록시를 켤 수 있습니다.
Related MCP server: @dealx/mcp-server
✨ Features
기능 | 설명 |
🔍 매물 검색 | 키워드·동네 슬러그 기반 당근마켓 검색 |
📦 상세 조회 | 게시글 상세 · 판매자 · 매너온도 조회 |
📉 시세 확인 | 검색 결과 기반 가격 범위 · 요약 |
📍 동네 슬러그 | 인근 동네 목록 · 슬러그 유효성 확인 |
🔌 stdio MCP | Cursor, Claude, Codex 등 로컬 클라이언트 지원 |
📦 Zero setup |
|
🚀 Quick Start
git clone https://github.com/iamkw0n/danggn-mcp.git
cd danggn-mcp
npm install
npm start공통 실행 명령:
node dist/index.js🛠 Tools
Tool | Description |
| 키워드 매물 검색 |
| 게시글 상세 · 판매 정보 |
| 검색 결과 기반 시세 요약 |
| 인근 동네 슬러그 목록 |
| 동네 슬러그 유효성 확인 |
| 프록시 상태 확인 |
💬 One-Click Install Prompt
Cursor / Claude Code / Codex에서 아래 프롬프트를 붙여넣으면 MCP 설치를 요청할 수 있습니다.
Github에서 iamkw0n/danggn-mcp 를 가져와서 MCP 서버 설치를 해줘.🔧 Client Setup
Client | Config file | stdio |
Cursor |
| ✅ |
Claude Code |
| ✅ |
Claude Desktop |
| ✅ |
Codex |
| ✅ |
ChatGPT | Connector URL | ❌ |
Cursor
프로젝트 루트에 .cursor/mcp.json:
{
"mcpServers": {
"danggn-mcp": {
"command": "node",
"args": ["./dist/index.js"],
"cwd": "${workspaceFolder}"
}
}
}Claude Code
프로젝트 루트에 .mcp.json:
{
"mcpServers": {
"danggn-mcp": {
"type": "stdio",
"command": "node",
"args": ["./dist/index.js"]
}
}
}CLI:
claude mcp add danggn-mcp -s project -- node ./dist/index.jsClaude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"danggn-mcp": {
"command": "node",
"args": ["/absolute/path/to/danggn-mcp/dist/index.js"],
"cwd": "/absolute/path/to/danggn-mcp"
}
}
}Claude Desktop은${workspaceFolder}를 지원하지 않습니다. 절대 경로를 사용하세요.
OpenAI Codex
프로젝트 .codex/config.toml 또는 ~/.codex/config.toml:
[mcp_servers.danggn-mcp]
command = "node"
args = ["./dist/index.js"]
cwd = "/absolute/path/to/danggn-mcp"
enabled = trueCLI:
codex mcp add danggn-mcp -- node ./dist/index.js연결 확인: Codex 세션에서 /mcp
ChatGPT
ChatGPT 커넥터는HTTPS MCP 엔드포인트만 지원합니다. 이 레포는 로컬 stdio 서버이므로 ChatGPT에 직접 연결할 수 없습니다.
💡 Examples
갤럭시북 당근마켓 검색해줘아이폰 15 강남구 근처 당근 매물 찾아줘iamkw0n 게시글 상세 보여줘맥북 당근 시세 요약해줘역삼동 동네 슬러그 찾아줘강남구-386 슬러그 유효한지 확인해줘프록시 상태 확인해줘⚙️ How It Works
flowchart LR
A[MCP Client] -->|stdio| B[danggn-mcp]
B --> C[www.daangn.com/kr/buy-sell]
B --> D[fleamarketArticles JSON]
B --> E[JSON-LD Product/ItemList]
B --> F[api.zyte.com/v1/extract]Endpoint | Usage |
| 매물 검색 |
| 게시글 상세 |
| 검색 결과 임베디드 JSON |
| 차단 대응용 프록시 |
동네 슬러그 형식
검색 범위를 좁히려면 regionSlug에 동네이름-숫자ID 형식을 사용하세요.
예: 강남구-386, 역삼동-6035
list_nearby_regions로 기본 페이지에 노출되는 인근 동네를 확인할 수 있습니다.
📄 License
MIT © iamkw0n
Available Tools
6 toolsget_listing_detailB
당근마켓 게시글 상세 정보를 조회합니다.
Inputs: articleRef (required).
list_nearby_regionsA
당근마켓 기본 페이지에 노출되는 인근 동네 슬러그 목록을 조회합니다.
Inputs: limit, keyword.
proxy_statusA
당근마켓 요청의 차단 상태와 Zyte 프록시 사용 여부를 확인합니다.
Inputs: no named parameters.
search_listingsB
당근마켓에서 중고거래 매물을 검색합니다.
Inputs: query (required), sort, limit, maxPrice, +3 more.
summarize_search_marketB
당근마켓 검색 결과를 바탕으로 간단한 시세 요약을 만듭니다.
Inputs: query (required), limit, maxPrice, minPrice, +2 more.
validate_region_slugB
당근마켓 동네 슬러그가 유효한지 확인합니다.
Inputs: regionSlug (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a distinct purpose: searching, retrieving details, summarizing market data, and managing region slugs, with no overlap between them.
Most tools follow a verb_noun pattern (search, get, list, validate, summarize), but 'proxy_status' is a noun phrase, slightly breaking the convention.
Six tools is well-scoped for a marketplace search and analysis server, covering core operations without unnecessary bloat.
The server covers search, detail retrieval, market summarization, and region utilities, but lacks listing creation or advanced filtering options, which are minor gaps for a read-only market analysis tool.
Related MCP Connectors
The agent-native marketplace for AI data: search listings and read their price and rights.
Web search, point-in-time crypto market data, verified strategy track records and 160+ agent tools.
Unblocking and fresh web data for agents: URL to Markdown, YouTube, Maps, Amazon, jobs. Pay per call
Web search, URL content extraction to Markdown, site mapping, and recursive web crawler.
Related MCP Servers
AlicenseBqualityCmaintenanceA Model Context Protocol implementation that enables AI agents to retrieve game data from OP.GG for League of Legends, Teamfight Tactics, Valorant, and esports through function calling.24105MIT
@dealx/mcp-serverofficial
AlicenseNot gradedqualityFmaintenanceEnables LLMs to search for ads on the DealX platform via the Model Context Protocol.11 npm2MIT- FlicenseBqualityDmaintenanceEnables querying the DuckDuckGo Instant Answer API through the Model Context Protocol, allowing users to perform searches and retrieve instant answers.19-
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to search ads on the DealX platform through the Model Context Protocol.11 npmMIT