amienbou121/crawl4ai-mcp-server

๐Ÿ•ท๏ธ AI ์—์ด์ „ํŠธ๊ฐ€ ์›น์„ ์†์‰ฝ๊ฒŒ ์Šคํฌ๋ž˜ํ•‘ํ•˜๊ณ  ํฌ๋กค๋งํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•˜๋Š” ๊ฒฝ๋Ÿ‰ Model Context Protocol ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค. ์›Œํฌํ”Œ๋กœ์šฐ์— ์™„๋ฒฝํ•˜๊ฒŒ ํ†ตํ•ฉ๋ฉ๋‹ˆ๋‹ค.

crawl4ai-mcp-server๋ž€ ๋ฌด์—‡์ธ๊ฐ€์š”?

์ด ๊ธฐ์ˆ ์€ AI ์—์ด์ „ํŠธ(์˜ˆ: Claude Code, Cursor, Codex ๋“ฑ)๊ฐ€ ์›น ํŽ˜์ด์ง€๋ฅผ ์Šคํฌ๋ž˜ํ•‘ํ•˜๊ณ  ํฌ๋กค๋งํ•  ์ˆ˜ ์žˆ๋„๋ก ์ง€์›ํ•˜๋Š” ๊ฒฝ๋Ÿ‰ MCP(Model Context Protocol) ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค. ์›น ๋ฐ์ดํ„ฐ ์ˆ˜์ง‘ ์ž‘์—…์„ ์ž๋™ํ™”ํ•˜๊ณ  AI ์—์ด์ „ํŠธ์˜ ์˜์‚ฌ ๊ฒฐ์ • ๋ฐ ๋ถ„์„์„ ์œ„ํ•œ ์‹ค์‹œ๊ฐ„ ์›น ์ฝ˜ํ…์ธ ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ฃผ๋กœ Claude Code, Cursor์™€ ๊ฐ™์€ MCP ํ˜ธํ™˜ ํ”Œ๋žซํผ์—์„œ ์‚ฌ์šฉ๋˜๋ฉฐ, ์‚ฌ์šฉ์ž๋Š” ๊ฐ„๋‹จํ•œ ๋„๊ตฌ ํ˜ธ์ถœ์„ ํ†ตํ•ด ๋ณต์žกํ•œ ์›น ์Šคํฌ๋ž˜ํ•‘ ์ž‘์—…์„ ์—์ด์ „ํŠธ์— ์œ„์ž„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. SKILL.md ๋ฌธ์„œ์—๋Š” ์„œ๋ฒ„ ์„ค์ • ๋ฐฉ๋ฒ•, ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋„๊ตฌ(์˜ˆ: `crawl_web` ๋ฐ `scrape_page`), ๊ทธ๋ฆฌ๊ณ  ๊ฐ ๋„๊ตฌ์˜ ์ž…๋ ฅ/์ถœ๋ ฅ ์Šคํ‚ค๋งˆ๊ฐ€ ์ƒ์„ธํžˆ ์„ค๋ช…๋˜์–ด ์žˆ์–ด ๊ฐœ๋ฐœ์ž๊ฐ€ ์‰ฝ๊ฒŒ ํ†ตํ•ฉํ•˜๊ณ  ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ง€์› ๋Œ€์ƒ~Claude Code~Codex CLI~Cursor
npx skills add amienbou121/crawl4ai-mcp-server

Installed? Explore more ์—ฐ๊ตฌ & ๋ฐ์ดํ„ฐ ๋ถ„์„ skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review ยท View all 6 โ†’

์ฆ๊ฒจ ์‚ฌ์šฉํ•˜๋Š” AI์—๊ฒŒ ๋ฌผ์–ด๋ณด๊ธฐ

์ด ์—์ด์ „ํŠธ ์Šคํ‚ฌ์ด ๋ฏธ๋ฆฌ ๋กœ๋“œ๋œ ์ƒˆ ์ฑ„ํŒ…์„ ์—ฝ๋‹ˆ๋‹ค.

๋ฌธ์„œ

crawl4ai-mcp-server์€(๋Š”) ๋ฌด์—‡์„ ํ•˜๋‚˜์š”?

๐Ÿ•ท๏ธ AI ์—์ด์ „ํŠธ๊ฐ€ ์›น์„ ์†์‰ฝ๊ฒŒ ์Šคํฌ๋ž˜ํ•‘ํ•˜๊ณ  ํฌ๋กค๋งํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•˜๋Š” ๊ฒฝ๋Ÿ‰ Model Context Protocol ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค. ์›Œํฌํ”Œ๋กœ์šฐ์— ์™„๋ฒฝํ•˜๊ฒŒ ํ†ตํ•ฉ๋ฉ๋‹ˆ๋‹ค.

๊ฐœ์š”

crawl4ai-mcp-server๋Š” MCP(Model Context Protocol)๋ฅผ ๊ตฌํ˜„ํ•œ ์„œ๋ฒ„๋กœ, AI ์—์ด์ „ํŠธ๊ฐ€ ์›น ํŽ˜์ด์ง€๋ฅผ ์Šคํฌ๋ž˜ํ•‘ํ•˜๊ณ  ํฌ๋กค๋งํ•  ์ˆ˜ ์žˆ๋Š” ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ฃผ์š” ๊ธฐ๋Šฅ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

  • ์›น ํฌ๋กค๋ง: crawl_web ๋„๊ตฌ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์›น์‚ฌ์ดํŠธ๋ฅผ ํฌ๋กค๋งํ•˜๊ณ  ๋งํฌ๋ฅผ ์ถ”์ถœํ•ฉ๋‹ˆ๋‹ค.
  • ํŽ˜์ด์ง€ ์Šคํฌ๋ž˜ํ•‘: scrape_page ๋„๊ตฌ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ํŠน์ • URL์˜ ์ฝ˜ํ…์ธ ๋ฅผ ์Šคํฌ๋ž˜ํ•‘ํ•ฉ๋‹ˆ๋‹ค.

์„ค์น˜

npm install crawl4ai-mcp-server

๋˜๋Š”

yarn add crawl4ai-mcp-server

์‚ฌ์šฉ๋ฒ•

MCP ํด๋ผ์ด์–ธํŠธ ์„ค์ •

claude_desktop_config.json ํŒŒ์ผ์— ๋‹ค์Œ์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค:

{
  "mcpServers": {
    "crawl4ai": {
      "command": "npx",
      "args": ["-y", "crawl4ai-mcp-server"]
    }
  }
}

๋„๊ตฌ

์„œ๋ฒ„๋Š” ๋‹ค์Œ ๋„๊ตฌ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค:

crawl_web

์›น์‚ฌ์ดํŠธ๋ฅผ ํฌ๋กค๋งํ•˜๊ณ  ๋งํฌ๋ฅผ ์ถ”์ถœํ•ฉ๋‹ˆ๋‹ค.

์ž…๋ ฅ:

  • url (๋ฌธ์ž์—ด): ํฌ๋กค๋งํ•  URL
  • max_depth (์ˆซ์ž, ์„ ํƒ ์‚ฌํ•ญ): ์ตœ๋Œ€ ํฌ๋กค๋ง ๊นŠ์ด (๊ธฐ๋ณธ๊ฐ’: 1)
  • max_pages (์ˆซ์ž, ์„ ํƒ ์‚ฌํ•ญ): ํฌ๋กค๋งํ•  ์ตœ๋Œ€ ํŽ˜์ด์ง€ ์ˆ˜ (๊ธฐ๋ณธ๊ฐ’: 10)

์ถœ๋ ฅ:

  • ์ถ”์ถœ๋œ ๋งํฌ ๋ชฉ๋ก

scrape_page

ํŠน์ • URL์˜ ์ฝ˜ํ…์ธ ๋ฅผ ์Šคํฌ๋ž˜ํ•‘ํ•ฉ๋‹ˆ๋‹ค.

์ž…๋ ฅ:

  • url (๋ฌธ์ž์—ด): ์Šคํฌ๋ž˜ํ•‘ํ•  URL

์ถœ๋ ฅ:

  • ํŽ˜์ด์ง€์˜ ๋งˆํฌ๋‹ค์šด ํ˜•์‹ ์ฝ˜ํ…์ธ 

์˜ˆ์‹œ

Claude Code์—์„œ ์‚ฌ์šฉํ•˜๊ธฐ

๋ผ์ด์„ ์Šค

MIT

๊ด€๋ จ ์Šคํ‚ฌ