naver-data-mcp-server
3.1
If you are the rightful owner of naver-data-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This project provides a server that offers the Naver Data Lab API through a Model Context Protocol (MCP) interface.
๋ค์ด๋ฒ ๋ฐ์ดํฐ๋ฉ MCP ์๋ฒ
์ด ํ๋ก์ ํธ๋ ๋ค์ด๋ฒ ๋ฐ์ดํฐ๋ฉ API๋ฅผ Model Context Protocol(MCP) ์ธํฐํ์ด์ค๋ก ์ ๊ณตํ๋ ์๋ฒ์ ๋๋ค.
๊ธฐ๋ฅ
๊ฒ์์ด ํธ๋ ๋
- ๋ค์ด๋ฒ ๋ฐ์ดํฐ๋ฉ ํตํฉ ๊ฒ์์ด ํธ๋ ๋ API ์ ๊ณต
- ๊ฒ์์ด ๊ทธ๋ฃน๋ณ ํธ๋ ๋ ์กฐํ (์ต๋ 5๊ฐ ๊ทธ๋ฃน, ๊ทธ๋ฃน๋น ์ต๋ 5๊ฐ ๊ฒ์์ด)
- ๊ธฐ๊ฐ, ์ฑ๋ณ, ์ฐ๋ น๋, ๋๋ฐ์ด์ค ๊ธฐ์ค ํํฐ๋ง ์ง์
์ผํ์ธ์ฌ์ดํธ
- ์ผํ ๋ถ์ผ๋ณ ํธ๋ ๋ ์กฐํ ๊ธฐ๋ฅ (์ต๋ 3๊ฐ ๋ถ์ผ)
- ํน์ ์ผํ ๋ถ์ผ ๋ด ํค์๋๋ณ ํธ๋ ๋ ์กฐํ ๊ธฐ๋ฅ (์ต๋ 3๊ฐ ํค์๋)
- ๊ธฐ๊ฐ, ์ฑ๋ณ, ์ฐ๋ น๋, ๋๋ฐ์ด์ค ๊ธฐ์ค ํํฐ๋ง ์ง์
์ค์น
npm์ ํตํ ์ค์น
npm install -g naver-datalab-mcp-server
์์ค์ฝ๋๋ก ์ค์น
# ์ ์ฅ์ ํด๋ก
git clone https://github.com/sonhyeonho/naver-data-lab-mcp-server.git
cd naver-data-lab-mcp-server
# ์์กด์ฑ ์ค์น ๋ฐ ๋น๋
npm install
npm run build
๊ฐ๋ฐ ํ๊ฒฝ ์ค์
ํ๊ฒฝ ๋ณ์ ์ค์
.env
ํ์ผ์ ์์ฑํ๊ณ ๋ค์ ๋ด์ฉ์ ์ถ๊ฐํฉ๋๋ค:
# .env.example ํ์ผ์ ๋ณต์ฌํ์ฌ .env ํ์ผ ์์ฑ
cp .env.example .env
# .env ํ์ผ์ ์ด๊ณ ๋ค์ ๋ด์ฉ์ ์์
NAVER_CLIENT_ID=your_naver_client_id_here
NAVER_CLIENT_SECRET=your_naver_client_secret_here
๊ฐ๋ฐ ์๋ฒ ์คํ
# ๊ฐ๋ฐ ๋ชจ๋๋ก ์คํ
npm run dev
# ๋น๋
npm run build
# ์คํ
npm start
API ์ฌ์ฉ ๋ฐฉ๋ฒ
๊ฒ์์ด ํธ๋ ๋ ์กฐํ
{
startDate: "2024-01-01", // YYYY-MM-DD ํ์
endDate: "2024-01-31", // YYYY-MM-DD ํ์
timeUnit: "date", // "date" | "week" | "month"
keywordGroups: [ // ์ต๋ 5๊ฐ ๊ทธ๋ฃน
{
groupName: "๊ทธ๋ฃน1",
keywords: ["๊ฒ์์ด1", "๊ฒ์์ด2"] // ๊ทธ๋ฃน๋น ์ต๋ 5๊ฐ
}
],
device: "pc", // ์ ํ์ฌํญ: "pc" | "mo" | ""
gender: "f", // ์ ํ์ฌํญ: "f" | "m" | ""
ages: ["20", "30"] // ์ ํ์ฌํญ: ["1"~"11"]
}
์ผํ์ธ์ฌ์ดํธ ๋ถ์ผ๋ณ ํธ๋ ๋ ์กฐํ
{
startDate: "2024-01-01",
endDate: "2024-01-31",
timeUnit: "date",
category: [ // ์ต๋ 3๊ฐ ๋ถ์ผ
{
name: "ํจ์
์๋ฅ",
param: ["50000000"] // ๋ค์ด๋ฒ ์ผํ ์นดํ
๊ณ ๋ฆฌ ์ฝ๋
}
],
device: "pc", // ์ ํ์ฌํญ
gender: "f", // ์ ํ์ฌํญ
ages: ["20", "30"] // ์ ํ์ฌํญ
}
์ผํ์ธ์ฌ์ดํธ ํค์๋๋ณ ํธ๋ ๋ ์กฐํ
{
startDate: "2024-01-01",
endDate: "2024-01-31",
timeUnit: "date",
category: "50000000", // ์ผํ ๋ถ์ผ ์ฝ๋
keyword: [ // ์ต๋ 3๊ฐ ํค์๋
{
name: "ํค์๋1",
param: ["๊ฒ์์ด1", "๊ฒ์์ด2"] // ์ต๋ 5๊ฐ
}
],
device: "pc", // ์ ํ์ฌํญ
gender: "f", // ์ ํ์ฌํญ
ages: ["20", "30"] // ์ ํ์ฌํญ
}
์ฐ๋ น๋ ์ฝ๋
- "1": 0-12์ธ
- "2": 13-18์ธ
- "3": 19-24์ธ
- "4": 25-29์ธ
- "5": 30-34์ธ
- "6": 35-39์ธ
- "7": 40-44์ธ
- "8": 45-49์ธ
- "9": 50-54์ธ
- "10": 55-59์ธ
- "11": 60์ธ ์ด์
API ์ฐธ๊ณ ์๋ฃ
- ๋ค์ด๋ฒ ๋ฐ์ดํฐ๋ฉ ๊ฒ์์ด ํธ๋ ๋ API ๋ฌธ์
- ๋ค์ด๋ฒ ๋ฐ์ดํฐ๋ฉ ์ผํ์ธ์ฌ์ดํธ API ๋ฌธ์
MCP ์๋ฒ ์ค์
MCP ์๋ฒ ์คํ
npx -y naver-datalab-mcp-server
MCP ์ค์ ์์
{
"naver-datalab": {
"command": "npx",
"args": [
"-y",
"naver-datalab-mcp-server"
],
"env": {
"NAVER_CLIENT_ID": "your_naver_client_id_here",
"NAVER_CLIENT_SECRET": "your_naver_client_secret_here"
}
}
}
์์คํ ์๊ตฌ์ฌํญ
- Node.js >= 18.0.0
๋ผ์ด์ ์ค
MIT