๐ท๏ธ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
title: "Scrapling MCP ์๋ฒ ์ค์ ๊ณผ ์คํฌ๋ํ ์์ " description: "AI ํด๋ผ์ด์ธํธ๋ฅผ Scrapling์ ์ฐ๊ฒฐํด HTTP์ ๋ธ๋ผ์ฐ์ ๋ก ์คํฌ๋ํํ์ธ์. ์ธ์ , ์ ์ฅํ ๋ก๊ทธ์ธ ์ํ, ๋ธ๋ผ์ฐ์ ๋์, ์ ํ ์ถ์ถ, API ๊ธฐ๋ก์ ์ฌ์ฉํ ์ ์์ต๋๋ค."
Scrapling MCP ์๋ฒ ์๋ด {#scrapling-mcp-server-guide}
Scrapling MCP ์๋ฒ๋ ์ฆ๊ฒจ ์ฐ๋ AI ์ฑ๋ด์ด๋ AI ์์ด์ ํธ์ Scrapling์ ์น ์คํฌ๋ํ ๊ธฐ๋ฅ์ ์ ๊ณตํฉ๋๋ค. Claude๋ MCP๋ฅผ ์ง์ํ๋ ์ธํฐํ์ด์ค์์ ๋ํํ๋ฉฐ ์น์ฌ์ดํธ๋ฅผ ์คํฌ๋ํํ๊ณ , ๋ฐ์ดํฐ๋ฅผ ์ถ์ถํ๊ณ , ๋ด ์ฐจ๋จ์ ์ฐํํ ์ ์์ต๋๋ค.
๊ธฐ๋ฅ {#features}
Scrapling MCP ์๋ฒ๋ ์น ์คํฌ๋ํ๊ณผ ๋ธ๋ผ์ฐ์ ์กฐ์์ ์ํ ๋๊ตฌ 16๊ฐ๋ฅผ ์ ๊ณตํฉ๋๋ค. ์ผํ์ฑ ๋๊ตฌ๋ URL ํ๋๋ฅผ ๊ฐ์ ธ์จ ๋ค ์ฌ์ฉํ ๋ธ๋ผ์ฐ์ ๋ ํด๋ผ์ด์ธํธ๋ฅผ ๋ซ์ต๋๋ค. ์ธ์ ๋๊ตฌ๋ ํธ์ถ ์ฌ์ด์ ์ฟ ํค์ ์ค์ ์ ์ ์งํฉ๋๋ค. ๋ฐ๋ผ์ AI๊ฐ ๊ฐ์ ํญ์์ ๋ธ๋ผ์ฐ์ ์์ ์ ์ด์ด ๊ฐ๊ณ ๋คํธ์ํฌ ๊ธฐ๋ก์ ํ์ธํ ์ ์์ต๋๋ค.
์ผํ์ฑ ๋๊ตฌ {#one-shot-tools}
๐ ๊ธฐ๋ณธ HTTP ์คํฌ๋ํ {#basic-http-scraping}
make_request: ์ฌ๋ฌ ๋ฉ์๋(GET, POST, PUT, DELETE)๋ก ๋น ๋ฅด๊ฒ HTTP ์์ฒญ์ ๋ณด๋ ๋๋ค. ๋ธ๋ผ์ฐ์ ์ง๋ฌธ ๋ชจ๋ฐฉ, TLS ๋ฒ์ ์ ๋ง๋ ์ค์ ๋ธ๋ผ์ฐ์ ํค๋ ์์ฑ, HTTP/3 ๋ฑ์ ์ง์ํฉ๋๋ค.
๐ ์คํ ์ค ๋ธ๋ผ์ฐ์ ์คํฌ๋ํ {#stealth-browser-scraping}
browser_fetch_once: ์คํ ์ค ๋ธ๋ผ์ฐ์ ๋ก JavaScript๋ฅผ ์คํํ๊ณ ๋์ ํ์ด์ง๋ฅผ ์คํฌ๋ํํฉ๋๋ค. ์ง๋ฌธ ์์ฅ, Cloudflare Turnstile/Interstitial ์ฐํ, ๋ธ๋ผ์ฐ์ ์ ์์ฒญ ์ค์ ์ ์ง์ํฉ๋๋ค.
์ธ์ ๋๊ตฌ {#session-tools}
๐ ์ธ์ ๊ด๋ฆฌ {#session-management}
browser_open: ์ฌ๋ฌbrowser_fetchํธ์ถ ์ฌ์ด์ ๊ณ์ ์ด๋ ค ์๋ ์คํ ์ค ๋ธ๋ผ์ฐ์ ์ธ์ ์ ๋ง๋ญ๋๋ค. ๋งค๋ฒ ์ ๋ธ๋ผ์ฐ์ ๋ฅผ ์คํํ๋ ๋ถ๋ด์ ์ค์ ๋๋ค. ๋ธ๋ผ์ฐ์ ์์ค์ ์ค์ ์ ๋ณด๊ดํ๊ณsession_id์session_type๋ง ๋ฐํํฉ๋๋ค. ์ค์ ์ ์ฉ๋settings๋list_sessions๋ก ํ์ธํ์ธ์. CDP ์ธ์ ์์๋ ๋น์ด ์์ต๋๋ค.open_request_session:session_make_request์์ ์ฌ์ฉํ๋ ์ง์ HTTP ์ธ์ ์ ๋ง๋ญ๋๋ค. ๋ธ๋ผ์ฐ์ ๋ ์ฌ์ฉํ์ง ์์ผ๋ฉฐ ์์ฒญ ์ฌ์ด์ ์ฟ ํค, ์ฐ๊ฒฐ, ๋ธ๋ผ์ฐ์ ์ง๋ฌธ(impersonate)์ ์ ์งํฉ๋๋ค.session_id์session_type๋ง ๋ฐํํ๊ณ ํ์ ์static์ ๋๋ค. ์ค์ ์ ์ฉ๋settings๋list_sessions๋ก ํ์ธํ์ธ์.close_session: ๋ธ๋ผ์ฐ์ ๋๋ HTTP ์ธ์ ์ ๋ซ๊ณ ์์์ ํด์ ํฉ๋๋ค.list_sessions: ํ์ฑ ์ธ์ ๊ณผ ๊ฐ ์ธ์ ์ ์ ๋ณด ๋ฐsettings๋ฅผ ๋์ดํฉ๋๋ค.
๋ธ๋ผ์ฐ์ ์ํ {#browser-state}
browser_save_state: ์ฟ ํค, ๋ก์ปฌ ์คํ ๋ฆฌ์ง, IndexedDB๋ฅผ Playwright ํธํ JSON ํ์ผ๋ก ์ ์ฅํฉ๋๋ค. ๋ธ๋ผ์ฐ์ ์ธ์ ์ด ๋๋ ๋ค์๋ ๋ก๊ทธ์ธ ์ํ๋ฅผ ์ฌ์ฌ์ฉํ ์ ์์ต๋๋ค. ๊ธฐ์กด ํ์ผ์ ๋ฎ์ด์๋๋ค.browser_load_state: ์ด๋ ค ์๋ ๋ธ๋ผ์ฐ์ ์ธ์ ์ ์ ์ฅํ ํ์ผ์ ๋ณต์ํฉ๋๋ค. ์ฒซ ํ์ด์ง๋ฅผ ๋ถ๋ฌ์ค๊ธฐ ์ ์๋ ์ฌ์ฉํ ์ ์์ต๋๋ค. ํ์ฌ ์ ์ฅ ์ํ๋ฅผ ๋ฐ๊พธ์ง๋ง ๊ธฐ์กด ํญ์ ๋ซ๊ฑฐ๋ ์ด๋ํ์ง๋ ์์ต๋๋ค. ๋ณต์ํ ๋ก๊ทธ์ธ ์ํ๋ฅผ ์ฌ์ฉํ๋ ค๋ฉด ํ์ด์ง๋ฅผ ๊ฐ์ ธ์ค๊ฑฐ๋ ์๋ก๊ณ ์นจํ์ธ์.
์ํ ํ์ผ์ MCP ์๋ฒ๊ฐ ์คํ๋๋ ์ปดํจํฐ์ ์ ์ฅ๋ฉ๋๋ค. sessionStorage, ์ด๋ฆฐ ํญ, ๋ธ๋ผ์ฐ์ ์ค์ ์ ํฌํจํ์ง ์์ต๋๋ค.
๐ฏ ์ธ์ ์ผ๋ก ๊ฐ์ ธ์ค๊ธฐ {#fetching-through-a-session}
browser_fetch: ์ด๋ ค ์๋ ์คํ ์ค ๋ธ๋ผ์ฐ์ ์ธ์ ์์ JavaScript๋ฅผ ์คํํ๊ณ URL ํ๋๋ฅผ ์คํฌ๋ํํฉ๋๋ค. ์ง๋ฌธ ์์ฅ๊ณผ Cloudflare Turnstile/Interstitial ์ฐํ๋ฅผ ์ง์ํฉ๋๋ค. ์์ ์ฐธ์กฐ, ์์น, ํฌ๊ธฐ๊ฐ ๋ด๊ธด ๊ตฌ์กฐํ๋ ํ์ด์ง ์ค๋ ์ท๋ ๋ง๋ค ์ ์์ต๋๋ค. AI๊ฐ ์กฐ์ํ ๋์์ ์ฐพ๊ณ ๋ง์ฐ์ค ๋์์ ๊ณํํ๋ ๋ฐ ๋์์ด ๋ฉ๋๋ค.session_make_request: ์ฌ๋ฌ ๋ฉ์๋(GET, POST, PUT, DELETE)๋ก ๋น ๋ฅด๊ฒ HTTP ์์ฒญ์ ๋ณด๋ ๋๋ค. ๋ธ๋ผ์ฐ์ ์ง๋ฌธ ๋ชจ๋ฐฉ, ์ด์ ๋ง๋ ํค๋, HTTP/3๋ฅผ ์ง์ํฉ๋๋ค.open_request_session์ผ๋ก ์ฐ ์ธ์ ์์ ์ฟ ํค, ์ฐ๊ฒฐ, ๋ธ๋ผ์ฐ์ ์ง๋ฌธ์ ์ฌ์ฌ์ฉํฉ๋๋ค.
๐ธ ์คํฌ๋ฆฐ์ท {#screenshots}
browser_screenshot: ์๋ก๊ณ ์นจ ์์ด ํ์ฌ ํ์ด์ง๋ ์ ํํ ์์๋ฅผ PNG ๋๋ JPEG๋ก ์บก์ฒํฉ๋๋ค. ์ ๋ ฅํ ํ๋, ์ด๋ฆฐ ๋ฉ๋ด, ์ฐจํธ, ๊ฒฐ๊ณผ ์นด๋๋ฅผ ํ์ธํ ์ ์์ต๋๋ค. ์์๋ง ์บก์ฒํ๋ฉด ๊ด๋ จ ์๋ ์ฃผ๋ณ ๋ด์ฉ์ ์ค์ผ ์ ์์ต๋๋ค. ํ์ฌ ๋ณด์ด๋ ์์ญ, ์ ์ฒด ํ์ด์ง, ์์ ํ๋๋ฅผ ์ง์ํ๋ฉฐ JPEG ํ์ง๋ ์กฐ์ ํ ์ ์์ต๋๋ค. ์คํฌ๋ฆฐ์ท์ ๋ชจ๋ธ์ด ์ง์ ๋ณผ ์ ์๋ ์ค์ ์ด๋ฏธ์ง ์ฝํ ์ธ ๋ธ๋ก์ผ๋ก ๋ฐํ๋ฉ๋๋ค.
ํ์ฌ ํ์ด์ง ๋ด์ฉ {#current-page-content}
browser_extract: ์๋ก๊ณ ์นจ ์์ด ํ์ฌ ํ์ด์ง๋ ์์ ํ๋๋ฅผ AI ์ค๋ ์ท, HTML, Markdown, ํ ์คํธ๋ก ์ฝ์ต๋๋ค. ํผ์ ์ ๋ ฅํ๊ฑฐ๋ ๋ด์ฉ์ ๋ ๋ถ๋ฌ์จ ๋ค์ ๊ฒฐ๊ณผ๋ ์ถ์ถํ ์ ์์ต๋๋ค. ์ค๋ ์ท์๋ ์ดํ ๋์์ ์ฌ์ฉํ ์์์ ์ญํ , ์ด๋ฆ, ์ฐธ์กฐ, ์์น, ํฌ๊ธฐ๊ฐ ํฌํจ๋ฉ๋๋ค. ์ ๊ท์ ๊ฒ์์ ์ผ์นํ๋ ์ค๋ ์ท ์ค๊ณผ ์ฃผ๋ณ ๋ฌธ๋งฅ, ๋ถ๋ชจ ๋ ธ๋๋ฅผ ๋ฐํํฉ๋๋ค.
๋ธ๋ผ์ฐ์ ๋์ {#browser-actions}
browser_actions: ํ ๋ฒ์ ํธ์ถ๋ก ๋ง์ฐ์ค ๋์, ํ๋ ์ ๋ ฅ, ํค๋ณด๋ ๋จ์ถํค, ๋ํ ์์ ์๋ต, ๋๊ธฐ๋ฅผ ์ด์ด์ ์คํํฉ๋๋ค. ์๋ฆผ์ด๋ ํ์ธ ์ฐฝ์ ์๋ฝํ๊ฑฐ๋ ๋ซ๊ณ , ์ ๋ ฅ ๋ํ ์์์ ํ ์คํธ๋ฅผ ๋ฃ์ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด ๊ฒ์์ฐฝ ์ ๋ ฅ, ์ ์ถ, ๊ฒฐ๊ณผ ๋๊ธฐ, ๊ฒฐ๊ณผ ์ด๊ธฐ๋ฅผ ํ ๋ฒ์ ์คํํ ์ ์์ต๋๋ค. AI๋ ์ด๋ฏธ ์๊ณ ์๋ ๋จ๊ณ๋ฅผ ๋ฌถ์ด์ ์คํํ๊ณ , ํ์ด์ง ๋ณํ๋ฅผ ํ์ธํ ๋๋ ์ค๋ ์ท์ ๋ฐ๋ก ๊ฐ์ ธ์ฌ ์ ์์ต๋๋ค. ๋จ๊ณ๋ง๋ค ์์ด์ ํธ์ ๋ค์ ํต์ ํ ํ์๊ฐ ์์ด, ์ ๊น๋ง ํ์๋๋ ๋ฉ๋ด๋ ๋น ๋ฅธ ํ์ ๋์์ด ํ์ํ ๋ค๋ฅธ ์กฐ์ ๋์์ ๋ค๋ฃฐ ๋ ๋์์ด ๋ฉ๋๋ค.๋ง์ฐ์ค๋ฅผ ์ฌ๋ ค ๋ฉ๋ด๋ ํดํ์ ํ์ํ๊ณ , ๋ฒํผ์ด๋ ๋งํฌ๋ฅผ ํด๋ฆญํ๊ณ , ์ค์ฒฉ ํจ๋ ์๋ก ์ด๋ํด ์ธ๋ก๋ ๊ฐ๋ก๋ก ์คํฌ๋กคํ ์ ์์ต๋๋ค. ์ด๋๊ณผ ํด๋ฆญ์๋ ์ ํ์, ์ค๋ ์ท ์ฐธ์กฐ, ์ขํ๋ฅผ ์ฌ์ฉํฉ๋๋ค. ๋์์ด ์์๋ผ๋ฉด ์๋์ผ๋ก ๊ธฐ๋ค๋ฆฐ ๋ค ํ๋ฉด ์์ผ๋ก ์คํฌ๋กคํฉ๋๋ค. ์ฌ๋ฌ ๋จ๊ณ์ ์ขํ ์ด๋, ์ผ์ชฝยท์ค๋ฅธ์ชฝยท๊ฐ์ด๋ฐ ๋ฒํผ ํด๋ฆญ, ๋๋ธ ํด๋ฆญ์ ์ง์ํฉ๋๋ค.
์ ํ์๋ ์ค๋ ์ท ์ฐธ์กฐ๋ก ํ์ด์ง ์ด๋์ ์๋ ํ๋๋ ์ง์ ํ ์ ์์ต๋๋ค. ํ ์คํธ ์ ๋ ฅ, ์ฒดํฌ๋ฐ์ค ์ ํ๊ณผ ํด์ , ๋ผ๋์ค ๋ฒํผ ์ ํ, ๊ธฐ๋ณธ ๋๋กญ๋ค์ด์์ ๋ณด์ด๋ ๋ผ๋ฒจ๋ก ํ๋ ์ด์์ ์ต์ ์ ํ์ ์ง์ํฉ๋๋ค. ๊ธฐ์กด ํ ์คํธ๋ฅผ ๋ฐ๊พธ๊ฑฐ๋ ์ง์ฐ๊ฑฐ๋ ํ์ฌ ์ปค์ ์์น์์ ์ด์ด ์ธ ์ ์์ต๋๋ค. ํค๋ณด๋ ๋จ์ถํค๋ก ํ ์คํธ ์ ํ๊ณผ ์ญ์ , ํฌ์ปค์ค ์ด๋, ํผ ์ ์ถ, ๋ฉ๋ด ๋ซ๊ธฐ๋ฅผ ํ ์ ์์ต๋๋ค. ๋๋ฆฐ ๋ชจ๋๋ ํ ๊ธ์์ฉ ์ ๋ ฅํ๋ฉฐ ๊ธ์ ์ฌ์ด์ ๋ชจ๋ ๋์ ์ฌ์ด์ ๋ฌด์์๋ก ์ ์ ๋ฉ์ถฅ๋๋ค.
๋ค์ ๋์ ์ ์ ๊ฒฐ๊ณผ๊ฐ ๋ํ๋๊ฑฐ๋ ๋ก๋ฉ ์ค๋ฒ๋ ์ด๊ฐ ์ฌ๋ผ์ง๊ฑฐ๋ ํ์ด์ง ๋ก๋ ์ด๋ฒคํธ๊ฐ ๋ฐ์ํ ๋๊น์ง ๊ธฐ๋ค๋ฆด ์ ์์ต๋๋ค. ์ ํด์ง ์๊ฐ ๋์ ๋ฉ์ถ๊ธฐ์ ๋คํธ์ํฌ ํ๋์ด ์ฆ์๋ค ๋๊น์ง ๊ธฐ๋ค๋ฆฌ๊ธฐ๋ ์ง์ํฉ๋๋ค.
JavaScript {#javascript}
browser_evaluate: ํ์ฌ ํ์ด์ง์์ JavaScript๋ฅผ ์คํํด ์ฌ์ฉ์ ์ ์ ๋ฐ์ดํฐ ์ถ์ถ, ๊ณ์ฐ, ํ์ด์ง๋ณ ์์ ์ ์ํํฉ๋๋ค. AI๊ฐ ์ฌ๋ฌ ์์์์ ๋ฐ์ดํฐ๋ฅผ ๋ชจ์ผ๊ฑฐ๋ ์ฑ ์ํ๋ฅผ ์ฝ๊ฑฐ๋ ํ์ด์ง ๋ด์ฉ์ ๋ฐ๊ฟ ์ ์์ต๋๋ค. ๋น๋๊ธฐ ์คํฌ๋ฆฝํธ๋ฅผ ์ง์ํ๊ณ ๊ฒฐ๊ณผ๋ JSON์ผ๋ก ๋ฐํํฉ๋๋ค.
๋คํธ์ํฌ ๊ธฐ๋ก {#network-history}
browser_network_requests: ํญ, ํ์ด์ง ๋ก๋, ๋ธ๋ผ์ฐ์ ๋์์ ๊ฑฐ์ณ ์๋ฃ๋ ์์ฒญ์ ์ฐพ์ต๋๋ค. ํ์ด์ง ๋ฐ์ดํฐ์ ์ถ์ฒ์ธ API ํธ์ถ, HTTP ์ค๋ฅ, ์ ์ฅํ ๋ฆฌ๋๋ ์ ์ ํ์ธํ ์ ์์ต๋๋ค. ๊ฒฐ๊ณผ๋ฅผ ์ค์ด๊ธฐ ์ํด ์ ์ ๋ฆฌ์์ค๋ ๊ธฐ๋ณธ์ผ๋ก ์จ๊น๋๋ค. ์์ฒญ ์ ๋ณด๋ฅผ JSON์ผ๋ก ๋ฐํํ๋ฉฐ ๊ธด ๊ธฐ๋ก์ ํ์ด์ง ๋จ์๋ก ์กฐํํ ์ ์์ต๋๋ค.browser_network_request: ๊ธฐ๋กํ ์์ฒญ ํ๋์ ์์ฝ, ํค๋, ๋ณด๋ธ ๋ฐ์ดํฐ, ํ ์คํธ ์๋ต ๋ณธ๋ฌธ์ ๊ตฌ์กฐํ๋ JSON์ผ๋ก ํ์ธํฉ๋๋ค. ํ์ด์ง๋ฅผ ๋ถ๋ฌ์ค๊ฑฐ๋ ์์ฒญ์ ๋ค์ ๋ณด๋ด์ง ์๊ณ ์ ํํ ๋ถ๋ถ์ ์ ๋ถ ๋ฐํํฉ๋๋ค. ์ ์ฅํ ์๋ต์ ํ์ด์ง๊ฐ ๋ฐ๋ ๋ค์๋ ๋จ์ต๋๋ค. ๊ธฐ๋ก ํฌ๊ธฐ์๋ ์ ํ์ด ์์ผ๋ฉฐ ํ ์คํธ๊ฐ ์๋ ๋ณธ๋ฌธ, ๋๋ฌด ํฐ ๋ณธ๋ฌธ, ์ฝ์ ์ ์๋ ๋ณธ๋ฌธ์๋ ์ด์ ๋ฅผ ํ์ํฉ๋๋ค. ํ์ํ ์ ๋ณด๋ MCP ์ธ์ ์ ๋ซ๊ธฐ ์ ์ ์ฝ์ผ์ธ์.
์๋ต ๋ณธ๋ฌธ์ HTML, JSON, XML, JavaScript ๋ฑ ์ง์ํ๋ ํ
์คํธ Content-Type์ธ ๊ฒฝ์ฐ์๋ง ์ฝ๊ณ ์ ์ฅํฉ๋๋ค. ๋ฐ์ด๋๋ฆฌ, ์ ์ ์๋ ํ์
, ํ์
์ด ์๋ ์๋ต์ ๋ณธ๋ฌธ์ ์ฝ๊ฑฐ๋ ์ ์ฅํ์ง ์๊ณ ์์ฒญ ๋ฉํ๋ฐ์ดํฐ์ ํค๋๋ง ๋ณด๊ดํฉ๋๋ค. ๋ธ๋ผ์ฐ์ ๋ ๋ฆฌ์์ค๋ฅผ ํ์์ฒ๋ผ ๋ถ๋ฌ์ต๋๋ค.
์๋ฃ๋ ์์ฒญ๋ง ์ ์ฅํ๋ฉฐ HTTP 4xx์ 5xx ์๋ต๋ ํฌํจํฉ๋๋ค. ์คํจํ๊ฑฐ๋ ์์ง ๋๋์ง ์์ ์์ฒญ์ ์ ์ธํฉ๋๋ค. ๊ธฐ๋ก์ด ๋๋ ๋ค ํญ๋ชฉ์ด ๋ํ๋๋ฉฐ, ๊ธฐ๋ก ์กฐํ๋ ์ธ์ ์ข ๋ฃ๋ ์ด๋ฅผ ๊ธฐ๋ค๋ฆฌ์ง ์์ต๋๋ค. ํ์ด์ง ์ด๋์ด๋ ์ข ๋ฃ ์์ ์ ๊ธฐ๋ก ์ค์ด๋ ํญ๋ชฉ์ ๋น ์ง ์ ์์ต๋๋ค. ์ ์ฅํ ๋ฐ์ดํธ๋ ๋ธ๋ผ์ฐ์ ์์ ๊ฐ์ ธ์ค๋ฏ๋ก ์๋ฒ๊ฐ ๋ณด๋ธ ๋ฐ์ดํธ์ ๋ค๋ฅผ ์ ์์ต๋๋ค. ์ ํจํ UTF-8์ด๋ผ๋ฉด Playwright์ ๊ฐ์ด UTF-8๋ก ์ฝ๊ณ , ๊ทธ๋ ์ง ์์ผ๋ฉด ๋ช ์๋ ๋ฌธ์ ์ธ์ฝ๋ฉ์ ์ฌ์ฉํฉ๋๋ค.
Shadow DOM {#shadow-dom}
์ด๋ฆฐ Shadow DOM์ ๋ด์ฉ์ ํฌํจํ๋ ค๋ฉด browser_fetch_once ๋๋ ๊ฐ browser_fetch ํธ์ถ์ pierce_shadow=true๋ฅผ ์ค์ ํ์ธ์. ๊ธฐ๋ณธ๊ฐ์ false์
๋๋ค. ์ ํ์ ์์ ์ ์ ํ ์ฌํญ์ Shadow DOM์ ์ฐธ๊ณ ํ์ธ์.
๋ธ๋ผ์ฐ์ ์ ํ์๋ก ๋ซํ Shadow DOM ์์ ์์๋ฅผ ์ง์ ํ๊ณ ์กฐ์ํ ์๋ ์์ต๋๋ค.
์ฃผ์ ๊ธฐ๋ฅ {#key-capabilities}
- ์ฝํ ์ธ ์ถ์ถ: ์นํ์ด์ง๋ ์์๋ฅผ Markdown, HTML๋ก ๋ฐ๊พธ๊ฑฐ๋ ์ ๋ฆฌ๋ ํ ์คํธ๋ฅผ ์ถ์ถํฉ๋๋ค.
- CSS ์ ํ์ ์ง์: AI์ ์ ๋ฌํ๊ธฐ ์ ์ Scrapling ์์ง์ผ๋ก ํ์ํ ์์๋ฅผ ์ ํํ ๊ณ ๋ฆ ๋๋ค.
- ๋ด ์ฐจ๋จ ์ฐํ: Cloudflare Turnstile, Interstitial ๋ฑ ์ฌ๋ฌ ๋ณดํธ ๋ฐฉ์์ ๋์ํฉ๋๋ค.
- ํ๋ก์ ์ง์: ์ต๋ช ์ฑ์ ๋์ด๊ณ ์ ์ ์ง์ญ์ ์ ํํ ์ ์์ต๋๋ค.
- ๋ธ๋ผ์ฐ์ ๋ชจ๋ฐฉ: TLS ์ง๋ฌธ, ํด๋น ๋ฒ์ ์ ๋ง๋ ์ค์ ๋ธ๋ผ์ฐ์ ํค๋ ๋ฑ์ ์ฌ์ฉํฉ๋๋ค.
- ์ธ์ ์ ์ง: ์ฌ๋ฌ ์์ฒญ์์ ๋ธ๋ผ์ฐ์ ์ธ์ ์ ์ฌ์ฌ์ฉํด ์ฑ๋ฅ์ ๋์ ๋๋ค.
- ๊ด๊ณ ์ฐจ๋จ: ๋ชจ๋ ๋ธ๋ผ์ฐ์ ๋๊ตฌ๊ฐ ์๋ ค์ง ๊ด๊ณ ยท์ถ์ ๋๋ฉ์ธ ์ฝ 3,500๊ฐ๋ก ๋ณด๋ด๋ ์์ฒญ์ ์๋์ผ๋ก ์ฐจ๋จํด ํ ํฐ์ ์ค์ด๊ณ ํ์ด์ง ๋ก๋๋ฅผ ๋น ๋ฅด๊ฒ ํฉ๋๋ค.
- ํ๋กฌํํธ ์ธ์ ์ ๋ฐฉ์ง: ๊ณต๊ฒฉ์ ์ฐ์ผ ์ ์๋ ์จ๊ฒจ์ง ๋ด์ฉ์ ์๋์ผ๋ก ์ ๊ฑฐํฉ๋๋ค. ์ธ๋ผ์ธ ์คํ์ผ๋ก ์จ๊ธด ์์, aria-hidden, ์จ๊ฒจ์ง ์ฌ๋กฏ, ๋๋น๊ฐ 0์ธ ๋ฌธ์, HTML ์ฃผ์, template ํ๊ทธ๊ฐ ๋์์ ๋๋ค.
์ค์น {#installation}
MCP๋ฅผ ์ง์ํ๋ Scrapling์ ์ค์นํ๊ณ ๋ธ๋ผ์ฐ์ ์์กด์ฑ๋ ์ค์น๋์ด ์๋์ง ํ์ธํ์ธ์.
# Install Scrapling with MCP server dependencies
pip install "scrapling[ai]"
# Install browser dependencies
scrapling install
Docker ๋ ์ง์คํธ๋ฆฌ์ ์ด๋ฏธ์ง๋ฅผ ๋ฐ๋ก ์ฌ์ฉํ ์๋ ์์ต๋๋ค.
docker pull pyd4vinci/scrapling
GitHub ๋ ์ง์คํธ๋ฆฌ์์๋ ๋ค์ด๋ก๋ํ ์ ์์ต๋๋ค.
docker pull ghcr.io/d4vinci/scrapling:latest
MCP ์๋ฒ ์ค์ {#setting-up-the-mcp-server}
์ฌ๊ธฐ์๋ Claude Desktop๊ณผ Claude Code์ Scrapling MCP ์๋ฒ๋ฅผ ์ถ๊ฐํ๋ ๋ฐฉ๋ฒ์ ์ค๋ช ํฉ๋๋ค. MCP๋ฅผ ์ง์ํ๋ ๋ค๋ฅธ ์ฑ๋ด๋ ๊ฐ์ ๋ฐฉ์์ผ๋ก ์ค์ ํ ์ ์์ต๋๋ค.
!!! note "์ฐธ๊ณ "
์๋์ scrapling-mcp ๋ช
๋ น์ v0.4.13์์ ์ถ๊ฐ๋์์ต๋๋ค. scrapling mcp๋ฅผ ๋ฐ๋ก ์คํํ๋ ๋จ์ถ ๋ช
๋ น์ผ๋ก, ๋ช
๋ น ํ๋๋ฅผ ์๊ตฌํ๋ MCP ๋ ์ง์คํธ๋ฆฌ๋ ํด๋ผ์ด์ธํธ์ ๋ฑ๋กํ๊ธฐ ์ฝ์ต๋๋ค. ์ด์ ๋ฒ์ ์์๋ scrapling ๋ช
๋ น์ ์ฒซ ๋ฒ์งธ ์ธ์๋ก mcp๋ฅผ ์ฌ์ฉํ์ธ์.
Claude Desktop {#claude-desktop}
- Claude Desktop์ ์ฝ๋๋ค.
- ์ผ์ชฝ ์ ๋ฉ๋ด(โฐ)์์ Settings โ Developer โ Edit Config๋ฅผ ์ ํํฉ๋๋ค.
- Scrapling MCP ์๋ฒ ์ค์ ์ ์ถ๊ฐํฉ๋๋ค.
"ScraplingServer": {
"command": "scrapling-mcp"
}
์ฒ์ MCP ์๋ฒ๋ฅผ ์ถ๊ฐํ๋ค๋ฉด ํ์ผ ์ ์ฒด๋ฅผ ๋ค์ ๋ด์ฉ์ผ๋ก ์ค์ ํ์ธ์.
{
"mcpServers": {
"ScraplingServer": {
"command": "scrapling-mcp"
}
}
}
๊ณต์ ์๋ด์ ๋ฐ๋ฅด๋ฉด, ์ด ์์ ์ ๊ธฐ์กด ์ค์ ํ์ผ์ ์ด๊ฑฐ๋ ํ์ผ์ด ์์ผ๋ฉด ์๋ก ๋ง๋ญ๋๋ค. ํ์ผ ์์น๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
ํ์คํ๊ฒ ์คํํ๋ ค๋ฉด scrapling-mcp ์คํ ํ์ผ์ ์ ์ฒด ๊ฒฝ๋ก๋ฅผ ์ฌ์ฉํ์ธ์.
- macOS:
which scrapling-mcp - Windows:
where scrapling-mcp
์ Mac์์๋ /Users/<MyUsername>/.venv/bin/scrapling-mcp๊ฐ ๋ฐํ๋์ด ์ต์ข
์ค์ ์ ๋ค์๊ณผ ๊ฐ์ด ์ฌ์ฉํ์ต๋๋ค.
{
"mcpServers": {
"ScraplingServer": {
"command": "/Users/<MyUsername>/.venv/bin/scrapling-mcp"
}
}
}
Docker {#docker}
Docker ์ด๋ฏธ์ง๋ฅผ ์ฌ์ฉํ๋ค๋ฉด ๋ค์๊ณผ ๊ฐ์ด ์ค์ ํฉ๋๋ค.
{
"mcpServers": {
"ScraplingServer": {
"command": "docker",
"args": [
"run", "-i", "--rm", "pyd4vinci/scrapling", "mcp"
]
}
}
}
Cursor, WindSurf ๋ฑ๋ ๊ฐ์ ๋ฐฉ์์ผ๋ก ์ค์ ํ ์ ์์ต๋๋ค.
Claude Code {#claude-code}
Claude Code์์๋ ๋ ๊ฐ๋จํฉ๋๋ค.
claude mcp add ScraplingServer "/Users/<MyUsername>/.venv/bin/scrapling-mcp"
Scrapling ์คํ ํ์ผ์ ๊ฒฝ๋ก๋ฅผ ํ์ธํ๋ ค๋ฉด ๋ค์ ๋ช ๋ น์ ์ฌ์ฉํ์ธ์.
- macOS:
which scrapling-mcp - Windows:
where scrapling-mcp
์์ธํ ๋ด์ฉ์ Anthropic์ Claude Code์ MCP ์๋ฒ ์ถ๊ฐํ๊ธฐ๋ฅผ ์ฐธ๊ณ ํ์ธ์.
์๋ฒ๋ฅผ ์ถ๊ฐํ ๋ค ์ฌ์ฉ ์ค์ธ ์ฑ์ ์์ ํ ์ข
๋ฃํ๊ณ ๋ค์ ์คํํ์ธ์. Claude Desktop์์๋ ์ฑํ
์
๋ ฅ์ฐฝ ์ค๋ฅธ์ชฝ ์๋์ MCP ์๋ฒ ํ์(๐ง)๊ฐ ๋ํ๋๊ฑฐ๋, ์
๋ ฅ์ฐฝ์ Search and tools ๋ฉ๋ด์ ScraplingServer๊ฐ ํ์๋ฉ๋๋ค.
๋ค๋ฅธ ๋ธ๋ผ์ฐ์ ์คํ ํ์ผ ์ฌ์ฉํ๊ธฐ {#custom-browser-executable}
browser_fetch_once์ browser_open์ ๊ธฐ๋ณธ Chromium ๋์ ๋ค๋ฅธ Chromium ํธํ ์คํ ํ์ผ์ ์ฌ์ฉํ ์ ์์ต๋๋ค. ์ฌ์ฉ์ ์ ์ ๋น๋๋ ๊ฐ๋ฒผ์ด ๋ธ๋ผ์ฐ์ ์์ง์ ์ธ ๋ ์ ์ฉํฉ๋๋ค.
MCP ์๋ฒ ์ ์ฒด์ ์ค์ ํ๋ ค๋ฉด ์๋ฒ๋ฅผ ์์ํ ๋ ์คํ ํ์ผ ๊ฒฝ๋ก๋ฅผ ์ ๋ฌํ์ธ์.
scrapling-mcp --executable-path "/path/to/chromium"
Claude Desktop ์ค์ ์์๋ ์๋ฒ ์ธ์์ ์ต์ ์ ์ถ๊ฐํฉ๋๋ค.
{
"mcpServers": {
"ScraplingServer": {
"command": "/Users/<MyUsername>/.venv/bin/scrapling-mcp",
"args": [
"--executable-path",
"/path/to/chromium"
]
}
}
}
์๋ฒ๋ฅผ ์์ํ๊ธฐ ์ ์ SCRAPLING_EXECUTABLE_PATH ํ๊ฒฝ ๋ณ์๋ฅผ ์ค์ ํ ์๋ ์์ต๋๋ค. ๊ทธ๋๋ AI๋ browser_fetch_once๋ก ํ ๋ฒ ๊ฐ์ ธ์ฌ ๋๋ browser_open์ผ๋ก ์ธ์
์ ์ด ๋ ๋ค๋ฅธ ์คํ ํ์ผ์ ์ ํํ ์ ์์ต๋๋ค.
์๊ฒฉ ๋ธ๋ผ์ฐ์ ์ ์ฐ๊ฒฐํ๊ธฐ {#connecting-to-remote-browsers}
browser_open์ด ๋ฐ๋์ ๋ก์ปฌ ๋ธ๋ผ์ฐ์ ๋ฅผ ์คํํด์ผ ํ๋ ๊ฒ์ ์๋๋๋ค. CDP URL์ ์ ๋ฌํ๋ฉด Chrome DevTools Protocol๋ก ์ด๋ฏธ ์คํ ์ค์ธ ๋ธ๋ผ์ฐ์ ์ ์ฐ๊ฒฐํฉ๋๋ค. ๊ฐ์ ์ปดํจํฐ, ๋ค๋ฅธ ํธ์คํธ, ๊ด๋ฆฌํ ๋ธ๋ผ์ฐ์ ์๋น์ค ๋ชจ๋ ๊ฐ๋ฅํฉ๋๋ค.
Open a stealthy browser session on wss://cdp.provider.example/session/abc123, then use it to scrape the product details from https://shop.example.com. Close the session when you're done.
๋ฐํ๋ session_id๋ ํ์์ฒ๋ผ browser_fetch, browser_extract, browser_actions, browser_evaluate, browser_screenshot, browser_network_requests, browser_network_request, browser_save_state, browser_load_state์ ์ฌ์ฉํฉ๋๋ค.
URL์๋ ๋ธ๋ผ์ฐ์ ์๋น์ค์์ ์ ๊ณตํ๋ WebSocket ์ฃผ์(ws:///wss://)๋, ์๊ฒฉ ๋๋ฒ๊น
ํฌํธ๋ฅผ ์ผ๊ณ ์ง์ ์คํํ ๋ธ๋ผ์ฐ์ ์ HTTP ์ฃผ์๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค.
chrome --remote-debugging-port=9222
์ด ๋ธ๋ผ์ฐ์ ์๋ cdp_url="http://localhost:9222"๋ก ์ฐ๊ฒฐํฉ๋๋ค. ๋ธ๋ผ์ฐ์ ๊ฐ ๋ค๋ฅธ ์ปดํจํฐ์์ ์คํ ์ค์ด๋ฉด ํด๋น ํธ์คํธ์ ์ฃผ์๋ฅผ ์ฌ์ฉํ์ธ์.
!!! note "์ฐธ๊ณ :"
* ๋ธ๋ผ์ฐ์ ๊ฐ ์ด๋ฏธ ์คํ ์ค์ด๋ฏ๋ก ์คํํ ๋๋ง ์ฐ๋ ์ต์
์ CDP ์ธ์
์์ ๋ฌด์๋ฉ๋๋ค. `headless`, `real_chrome`, `executable_path`๊ฐ ์ด์ ํด๋นํ๋ฉฐ, ์์์ ์ค๋ช
ํ ์๋ฒ ์ ์ฒด ๊ธฐ๋ณธ ๊ฒฝ๋ก๋ ํฌํจ๋ฉ๋๋ค.<br/>
* ๊ฐ ์ธ์
์ด ์๊ฒฉ ๋ธ๋ผ์ฐ์ ์ ๋ณ๋์ ๋ธ๋ผ์ฐ์ ์ปจํ
์คํธ๋ฅผ ๋ง๋ค๊ธฐ ๋๋ฌธ์ ๋๋จธ์ง ์ต์
(`locale`, `useragent`, `proxy`, `cookies`, `timezone_id` ๋ฑ)์ ๊ทธ๋๋ก ์ ์ฉ๋ฉ๋๋ค.
Streamable HTTP {#streamable-http}
๋ฒ์ 0.3.6๋ถํฐ ๊ธฐ์กด 'stdio' ์ ์ก ๋ฐฉ์ ๋์ 'Streamable HTTP' ์ ์ก ๋ฐฉ์์ผ๋ก MCP ์๋ฒ๋ฅผ ์คํํ ์ ์์ต๋๋ค.
๋ค์ 'stdio' ๋ช ๋ น ๋์ :
scrapling-mcp
์๋ ๋ช ๋ น์ผ๋ก 'Streamable HTTP' ์ ์ก ๋ฐฉ์์ ์ผ์ธ์.
scrapling-mcp --http
์๋ฒ๋ ๊ธฐ๋ณธ์ ์ผ๋ก ํธ์คํธ '127.0.0.1'์ ํฌํธ 8000์์ ์ฐ๊ฒฐ์ ๋ฐ์ต๋๋ค. ๋ ๊ฐ์ ๋ค์๊ณผ ๊ฐ์ด ๋ฐ๊ฟ ์ ์์ต๋๋ค.
scrapling-mcp --http --host '0.0.0.0' --port 8000
๊ธฐ๋ณธ ์ค์ ์์๋ ๊ฐ์ ์ปดํจํฐ์ ์ฐ๊ฒฐ๋ง ๋ฐ์ต๋๋ค. ๋คํธ์ํฌ์์ ์๋ฒ์ ์ฐ๊ฒฐํ ์ ์๊ฒ ํ๋ ค๋ฉด --host '0.0.0.0'์ ์ ๋ฌํ์ธ์. ์ด ์ค์ ๊ณผ ์๋์ ์ธ์ฆ ์ค์ ์ ๋ณ๊ฐ์
๋๋ค.
Docker ์์์ 'Streamable HTTP'๋ฅผ ์คํํ๋ ค๋ฉด ์ง์ '0.0.0.0'์ ๋ฐ์ธ๋ฉํ๊ณ ํ ํฐ์ ์ค์ ํด์ผ ํฉ๋๋ค. ๊ทธ๋ ์ง ์์ผ๋ฉด ๊ณต๊ฐํ ํฌํธ์์ ์๋ฒ์ ์ฐ๊ฒฐํ ์ ์์ต๋๋ค. ์ปจํ ์ด๋์ '127.0.0.1'์ ์ปจํ ์ด๋ ์์์๋ง ์ ๊ทผํ ์ ์๊ธฐ ๋๋ฌธ์ ๋๋ค.
docker run -p 8000:8000 -e SCRAPLING_MCP_AUTH_TOKEN="<your-token>" pyd4vinci/scrapling mcp --http --host '0.0.0.0'
์ธ์ฆ {#authentication}
'stdio' ์ ์ก ๋ฐฉ์์์๋ ์๋ฒ๋ฅผ ์์ํ ํ๋ก๊ทธ๋จ๋ง ์๋ฒ์ ์ฐ๊ฒฐํ ์ ์์ต๋๋ค. ํ์ง๋ง 'Streamable HTTP'๋ก ๋ฐ๊พธ๋ฉด ํฌํธ์ ์ ๊ทผํ ์ ์๋ ๋๊ตฌ๋ ๋ชจ๋ ๋๊ตฌ๋ฅผ ํธ์ถํ ์ ์์ต๋๋ค. ์๋ฒ๊ฐ ์คํ ์ค์ธ ์ปดํจํฐ์์ ์ด๋ค URL์ด๋ ๊ฐ์ ธ์ฌ ์๋ ์์ต๋๋ค. ์ด ๋๋ฌธ์ 'Streamable HTTP'์๋ ์ธ์ฆ์ด ํ์ํฉ๋๋ค. --http๋ง ์ ๋ฌํ๋ฉด ์๋ฒ๊ฐ ์์๋์ง ์๊ณ ํ ํฐ์ ์์ฒญํฉ๋๋ค.
scrapling-mcp --http --auth-token "$(openssl rand -hex 32)"
ํด๋ผ์ด์ธํธ๋ Authorization ํค๋์ ํ ํฐ์ ๋ณด๋ด์ผ ํฉ๋๋ค. ํ ํฐ์ด ์๋ ์์ฒญ์ 401๋ก ๊ฑฐ๋ถ๋ฉ๋๋ค.
{
"mcpServers": {
"ScraplingServer": {
"url": "https://your-server.example.com/mcp",
"headers": {
"Authorization": "Bearer <your-token>"
}
}
}
}
๋ช
๋ น์ค์ ํ ํฐ์ ๋ฃ์ผ๋ฉด ์
ธ ๊ธฐ๋ก๊ณผ ํ๋ก์ธ์ค ๋ชฉ๋ก์ ๋จ์ต๋๋ค. ๋ฐ๋ผ์ SCRAPLING_MCP_AUTH_TOKEN ํ๊ฒฝ ๋ณ์๋ฅผ ์ฌ์ฉํ์ธ์.
export SCRAPLING_MCP_AUTH_TOKEN="<your-token>"
scrapling-mcp --http
๊ธฐ๋ณธ ์ฃผ์ '127.0.0.1'์์ ๋ก์ปฌ ํ
์คํธ๋ฅผ ํ๋ ๊ฒฝ์ฐ์ฒ๋ผ ์ธ์ฆ ์๋ ์๋ฒ๊ฐ ํ์ํ๋ค๋ฉด --no-auth๋ก ๋ช
์ํด์ผ ํฉ๋๋ค.
scrapling-mcp --http --no-auth
--no-auth์ --host '0.0.0.0'์ ํจ๊ป ์ฌ์ฉํ๋ฉด ํฌํธ์ ์ ๊ทผํ ์ ์๋ ๋๊ตฌ๋ ๋ชจ๋ ๋๊ตฌ๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค. ์ ๋ขฐํ ์ ์๋ ๋คํธ์ํฌ ๋ฐ์์๋ ๋ ์ต์
์ ํจ๊ป ์ฌ์ฉํ์ง ๋ง์ธ์.
์๋ฒ๊ฐ ๊ณต์ฉ ์ฃผ์์์ ์ฐ๊ฒฐ์ ๋ฐ๋๋ค๋ฉด ํ์ฉํ ํธ์คํธ ์ด๋ฆ๋ ์ง์ ํ์ธ์. ๊ทธ๋ฌ๋ฉด DNS ๋ฆฌ๋ฐ์ธ๋ฉ ๊ณต๊ฒฉ์ ๋ง๋ ๋ณดํธ ๊ธฐ๋ฅ์ด ์ผ์ง๋๋ค. ์ด ๊ณต๊ฒฉ์ ๋ธ๋ผ์ฐ์ ๋ก ๋ฐฉ๋ฌธํ ์น์ฌ์ดํธ๊ฐ ์ฌ๋ฌ๋ถ์ ์๋ฒ์ ์ฐ๊ฒฐ์ ์๋ํ๋ ๋ฐฉ์์ ๋๋ค. ์ด ์ต์ ์ ์ฌ๋ฌ ๋ฒ ์ ๋ฌํ ์ ์์ต๋๋ค.
scrapling-mcp --http --allowed-host 'your-server.example.com:8000'
!!! note "์ฐธ๊ณ :"
* ์ธ์ฆ์ 'Streamable HTTP' ์ ์ก ๋ฐฉ์์๋ง ์ ์ฉ๋ฉ๋๋ค. 'stdio'์์๋ ๋ฌด์๋๋ฉฐ, ์๋ฒ๊ฐ ์ด๋ฅผ ์๋ฆฌ๋ ๊ฒฝ๊ณ ๋ฅผ ๊ธฐ๋กํฉ๋๋ค.<br/>
* ์ผ๋ฐ HTTP๋ ํ ํฐ์ ํ๋ฌธ์ผ๋ก ์ ์กํฉ๋๋ค. ์ธํฐ๋ท์ ๊ณต๊ฐํ๊ธฐ ์ ์ TLS ์ฐ๊ฒฐ์ ์ฒ๋ฆฌํ๋ ๋ฆฌ๋ฒ์ค ํ๋ก์ ๋ค์ ์๋ฒ๋ฅผ ๋์ธ์.<br/>
* ํด๋ผ์ด์ธํธ๋ง๋ค ๋ค๋ฅธ ์ธ์ฆ ์ ๋ณด๋ฅผ ์ฐ๋ ๋ฐฉ์์ด ์๋๋ผ ํ๋์ ๊ณต์ ํค๋ฅผ ์ฌ์ฉํฉ๋๋ค. ๋ชจ๋ ํด๋ผ์ด์ธํธ๊ฐ ๊ฐ์ ํ ํฐ์ ์ฐ๋ฉฐ, ํ ํฐ์ ๋ฐ๊พธ๋ ค๋ฉด ์๋ฒ๋ฅผ ๋ค์ ์์ํด์ผ ํฉ๋๋ค.<br/>
* `--http --no-auth`๋ก ์์ํ๋ฉด ์ธ์ฆ์ด ๊บผ์ ธ ์๋ค๋ ๊ฒฝ๊ณ ๊ฐ ๊ธฐ๋ก๋ฉ๋๋ค.<br/>
* `--auth-token`๊ณผ `--no-auth`๋ฅผ ํจ๊ป ์ ๋ฌํ๋ฉด ํ ํฐ์ ์ ์งํฉ๋๋ค. ์ธ์ฆ์ ์๋ฆฌ์ง ์๊ณ ํด์ ํ์ง ์์ต๋๋ค.
์์ {#examples}
MCP ์๋ฒ๋ฅผ ํ ์คํธํ ๋ ์ฌ์ฉํ ํ๋กฌํํธ๋ฅผ ๋ช ๊ฐ์ง ์๊ฐํฉ๋๋ค. ์ฌ๋ฌ๋ถ์ ๋ ์ฐฝ์์ ์ด๊ณ ๋ ์ข์ ํ๋กฌํํธ๋ฅผ ๋ง๋ค ์ ์์ ๊ฑฐ์์ :)
๊ฐ๋จํ ํ๋กฌํํธ๋ถํฐ ๋ณต์กํ ํ๋กฌํํธ๊น์ง ์ฐจ๋ก๋ก ์ดํด๋ด ๋๋ค. ์์ ์์๋ Claude Desktop์ ์ฌ์ฉํ์ง๋ง ๋ค๋ฅธ ํด๋ผ์ด์ธํธ์์๋ ๊ฐ์ ๋ฐฉ์์ผ๋ก ์ธ ์ ์์ต๋๋ค.
๊ธฐ๋ณธ ์น ์คํฌ๋ํ
์นํ์ด์ง์ ์ฃผ์ ๋ด์ฉ์ Markdown์ผ๋ก ์ถ์ถํฉ๋๋ค.
Scrape the main content from https://example.com and convert it to markdown format.Claude๋
make_request๋ก ํ์ด์ง๋ฅผ ๊ฐ์ ธ์ ์ฝ๊ธฐ ์ฌ์ด ๋ด์ฉ์ ๋ฐํํ ์ ์์ต๋๋ค. HTTP ์์ฒญ์ ๊ธฐ๋ณธ์ ์ผ๋ก ์ต๋ ์ธ ๋ฒ ์๋ํ๋ฉฐ, ๊ฐ ์๋ ์ฌ์ด์ 1์ด๋ฅผ ๊ธฐ๋ค๋ฆฝ๋๋ค. ํ์ด์ง์ JavaScript๊ฐ ํ์ํ๊ฑฐ๋ HTTP ์์ฒญ์ด ์ฐจ๋จ๋๋ฉด AI๊ฐbrowser_fetch_once๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค. ๋ ๋๊ตฌ ๋ชจ๋ ํธ์ถ ํ ์ฌ์ฉํ ๋ฆฌ์์ค๋ฅผ ์ ๋ฆฌํฉ๋๋ค.๊ฐ์ ์์ฒญ์ ๋ ํจ์จ์ ์ผ๋ก ์ฐ๋ ค๋ฉด ๋ค์๊ณผ ๊ฐ์ด ํฉ๋๋ค.
Use regular requests to scrape the main content from https://example.com and convert it to markdown format.์ด๋ ๊ฒ ํ๋ฉด Claude๊ฐ ์ฌ์ฉํ ๋๊ตฌ๋ฅผ ์ถ์ธกํ ํ์๊ฐ ์์ต๋๋ค. ๋๋ก๋ ์ผ๋ฐ ์์ฒญ์ผ๋ก ์์ํ๊ณ , ๋๋ก๋ ๋๋ ทํ ์ด์ ์์ด ๋ธ๋ผ์ฐ์ ๊ฐ ๋ ์ ํฉํ๋ค๊ณ ํ๋จํ๊ธฐ๋ ํฉ๋๋ค. ์๊ฐ๊ณผ ๋น์ฉ์ ์ค์ด๊ณ ์ผ๊ด๋ ๊ฒฐ๊ณผ๋ฅผ ์ป์ผ๋ ค๋ฉด ์ฌ์ฉํ ๋๊ตฌ๋ฅผ Claude์ ์ง์ ์๋ ค์ฃผ๋ ๊ฒ์ด ์ข์ต๋๋ค.
์ํ๋ ๋ฐ์ดํฐ๋ง ์ถ์ถํ๊ธฐ
CSS ์ ํ์๋ก ํน์ ์์๋ฅผ ์ถ์ถํฉ๋๋ค.
Get all product titles from https://shop.example.com using the CSS selector '.product-title'. If the request fails, retry up to 5 times every 10 seconds.์๋ฒ๋ ์ ํ์์ ๋ง๋ ์์๋ง ์ถ์ถํด ๊ตฌ์กฐํ๋ ๋ชฉ๋ก์ผ๋ก ๋ฐํํฉ๋๋ค. ์น์ฌ์ดํธ์ ์ฐ๊ฒฐ ๋ฌธ์ ๊ฐ ์์ ๋๋ฅผ ๋๋นํด ์ต๋ 5๋ฒ ์๋ํ๋๋ก ์ง์ ํ์ต๋๋ค. ๋๋ถ๋ถ์ ๊ฒฝ์ฐ์๋ ๊ธฐ๋ณธ ์ค์ ์ผ๋ก ์ถฉ๋ถํฉ๋๋ค.
์ผํ๋ชฐ ๋ฐ์ดํฐ ์์งํ๊ธฐ
์กฐ๊ธ ๋ ๋ณต์กํ ํ๋กฌํํธ์ ๋๋ค.
Open a stealthy browser session and visit these e-commerce URLs one at a time: - https://shop1.com/product-a - https://shop2.com/product-b - https://shop3.com/product-c Get the product names, prices, and descriptions from each page. Close the session when done.Claude๋ ํ๋์ ๋ธ๋ผ์ฐ์ ์ธ์ ์ ์ฌ์ฌ์ฉํ๊ณ ๊ฐ URL์ ๋ํด ์์๋๋ก
browser_fetch๋ฅผ ํธ์ถํ ๋ค ์ถ์ถํ ๋ฐ์ดํฐ๋ฅผ ๋ถ์ํ ์ ์์ต๋๋ค.๋ ๋ณต์กํ ์์ ํ๋ฆ
์ง๊ธ PlayStation ์คํ ์ด์ ์ฒซ ํ์ด์ง์ ์๋ ๋ชจ๋ ์ก์ ๊ฒ์์ ๊ฐ์ ธ์ค๊ณ ์ถ๋ค๋ฉด ๋ค์ ํ๋กฌํํธ๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค.
Extract the URLs of all games on this page, then visit each game in order and return a list of all action games: https://store.playstation.com/en-us/pages/browse์ผ๋ฐ ์์ฒญ์ผ๋ก ๋ฐ์ดํฐ๋ฅผ ๊ฐ์ ธ์ฌ ์ ์๋ค๋ฉด ๋ธ๋ผ์ฐ์ ๋ฅผ ์คํํ์ง ์๋๋ก HTTP ์ธ์ ์ ์ฌ์ฌ์ฉํ๋ผ๊ณ AI์ ์๋ ค์ฃผ์ธ์.
Open an HTTP session, extract the URLs of all games on this page, then fetch each game in order and return a list of all action games. Close the session when done: https://store.playstation.com/en-us/pages/browseCSS ์ ํ์๋ฅผ ์ธ ์ค ์๋ค๋ฉด AI๊ฐ ์ฝ๊ธฐ ์ ์ ๋ด์ฉ์ ๋ฒ์๋ฅผ ์ขํ ์๋ ์์ต๋๋ค.
Use an HTTP session to extract the URLs of all games on the page below, then fetch each game in order and return a list of all action games. The selector for games in the first page is `[href*="/concept/"]` and the selector for the genre in each game page is `[data-qa="gameInfo#releaseInformation#genre-value"]`. Close the session when done. URL: https://store.playstation.com/en-us/pages/browseCloudflare๋ก ๋ณดํธ๋ ์น์ฌ์ดํธ์์ ๋ฐ์ดํฐ ๊ฐ์ ธ์ค๊ธฐ
๋์ ์น์ฌ์ดํธ์ Cloudflare ๋ณดํธ ๊ธฐ๋ฅ์ด ์๋ค๊ณ ์๊ฐ๋๋ฉด Claude๊ฐ ์ง์ ์์๋ด๋๋ก ๋์ง ๋ง๊ณ ๋ฏธ๋ฆฌ ์๋ ค์ฃผ์ธ์.
What's the price of this product? Be cautious, as it utilizes Cloudflare's Turnstile protection. Make the browser visible while you work. https://ao.com/product/oo101uk-ninja-woodfire-outdoor-pizza-oven-brown-99357-685.aspx๊ธด ์์ ํ๋ฆ
๋ค์๊ณผ ๊ฐ์ ํ๋กฌํํธ๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค.
Extract all product URLs for the following category, then return the prices and details for the first 3 products. https://www.arnotts.ie/furniture/bedroom/bed-frames/ํ์ง๋ง ์๋์ฒ๋ผ ์ฐ๋ ํธ์ด ๋ ์ข์ต๋๋ค.
Go to the following category URL and extract all product URLs using the CSS selector "a". Then, reuse the session to fetch the first 3 product pages in order and extract each productโs price and details. Close the session when done. Keep the output in markdown format to reduce irrelevant content. Category URL: https://www.arnotts.ie/furniture/bedroom/bed-frames/์ง์ ์ธ์ ์ฌ์ฉํ๊ธฐ
๊ฐ์ ์ฌ์ดํธ์์ ์ฌ๋ฌ ํ์ด์ง๋ฅผ ์คํฌ๋ํํ ๋๋ ์ง์ ๋ธ๋ผ์ฐ์ ์ธ์ ์ ์ฌ์ฉํ์ธ์. ์์ฒญ๋ง๋ค ์ ๋ธ๋ผ์ฐ์ ๋ฅผ ์คํํ๋ ๋น์ฉ์ ์ค์ผ ์ ์์ต๋๋ค.
Open a stealthy browser session, then use it to scrape the main details from the first 5 product pages on https://shop.example.com. Close the session when you're done.Claude๋
browser_open์ผ๋ก ๊ณ์ ์ฌ์ฉํ ๋ธ๋ผ์ฐ์ ๋ฅผ ๋ง๋ค๊ณ , ๊ฐ์ ์ธ์ ์์ ๊ฐ ์ํ ํ์ด์ง์ ๋ํดbrowser_fetch๋ฅผ ํธ์ถํ ๋ค ๋ง์ง๋ง์close_session์ ํธ์ถํฉ๋๋ค. ํ์ด์ง๋ง๋ค ์ ๋ธ๋ผ์ฐ์ ๋ฅผ ์คํํ๋ ๊ฒ๋ณด๋ค ํจ์ฌ ๋น ๋ฆ ๋๋ค.!!! danger "์ํ"
์ง์ ์ธ์ ์ ์ฌ์ฉํ ๋ค์๋ ๋ฐ๋์ ๋ซ์ผ์ธ์. ๋ซ์ง ์์ผ๋ฉด ์ธ์ ์ด ๊ณ์ ์ด๋ ค ์์ต๋๋ค!๊ธด ์์ ํ๋ฆ์์ ์ง์ ์ธ์ ์ฌ์ฉํ๊ธฐ
Claude๊ฐ ์ฌ๋ฌ ๋จ๊ณ๋ฅผ ์๊ฐํด์ผ ํ๋ ๊ธด ํ ์คํธ ์์ ์ ๋๋ค.
Use Scrapling MCP to do the following in this order: 1. Open a stealthy browser session with headless mode off. 2. Go to this page and collect the number of stars: https://github.com/D4Vinci/Scrapling 3. From the README, get the URL that shows the number of downloads and go to it. 4. Get the number of downloads and the top 3 countries from the graph. 5. Prepare a report with the results. 6. Close the browser.
์ด๋ฐ ์์ผ๋ก ํ์ฉํ ์ ์์ต๋๋ค. ์ฌ๋ฌ๋ถ์ ์์ด๋์ด์ ๋ฐ๋ผ ๋ ๋ง์ ์์ ์ ํ ์ ์์ต๋๋ค.
๊ถ์ฅ ์ฌ์ฉ ๋ฐฉ๋ฒ {#best-practices}
๊ธฐ์ ์ ์ผ๋ก ์์๋๋ฉด ์ข์ ๋ช ๊ฐ์ง ํ์ ๋๋ค.
1. ์๋ง์ ๋๊ตฌ ์ ํํ๊ธฐ {#1-choose-the-right-tool}
make_request: ๋จ์ผ ํ์ด์ง๋ API ํธ์ถ์ ์ฐ๋ ๋น ๋ฅธ HTTP ์์ฒญbrowser_fetch_once: JavaScript๊ฐ ํ์ํ ๋จ์ผ ๋์ ํ์ด์ง๋ Cloudflare ๋ฑ์ผ๋ก ๋ณดํธ๋ ์ฌ์ดํธ- ์ธ์ ๋๊ตฌ: ์๋ก ๊ด๋ จ๋ ์์ฒญ, ๋ธ๋ผ์ฐ์ ์์ , ์คํฌ๋ฆฐ์ท, ๋คํธ์ํฌ ๊ธฐ๋ก
2. ์ฑ๋ฅ ๊ฐ์ ํ๊ธฐ {#2-optimize-performance}
- ์ธ์ ์ ์ฌ์ฌ์ฉํ๊ณ ๊ฐ URL์ ์์๋๋ก ๊ฐ์ ธ์ค์ธ์.
- ํ์ ์๋ ๋ฆฌ์์ค๋ ๋์ธ์.
- ์ ์ ํ ์ ํ ์๊ฐ์ ์ค์ ํ์ธ์.
- CSS ์ ํ์๋ก ํ์ํ ๋ด์ฉ๋ง ์ถ์ถํ์ธ์.
3. ๋์ ์ฝํ ์ธ ์ฒ๋ฆฌํ๊ธฐ {#3-handle-dynamic-content}
- SPA์๋
network_idle์ ์ฌ์ฉํ์ธ์. - ํน์ ์์๋ฅผ ๊ธฐ๋ค๋ฆฌ๋ ค๋ฉด
wait_selector๋ฅผ ์ค์ ํ์ธ์. - ๋๋ฆฌ๊ฒ ๋ก๋๋๋ ์ฌ์ดํธ์์๋ ์ ํ ์๊ฐ์ ๋๋ฆฌ์ธ์.
4. ๋ฐ์ดํฐ ํ์ง {#4-data-quality}
- ํ์ด์ง์ ๋ณธ๋ฌธ์ ์ ํํ๊ณ ์ ๋ฆฌํ๋ ค๋ฉด
main_content_only=true๋ฅผ ์ฌ์ฉํ์ธ์. - ์ฉ๋์ ๋ง๋
extraction_type์ ์ ํํ์ธ์.
5. ํ๋กฌํํธ ์ธ์ ์ ๋ฐฉ์ง {#5-prompt-injection-protection}
MCP ์๋ฒ๋ main_content_only๊ฐ ์ผ์ ธ ์์ผ๋ฉด ์คํฌ๋ํํ ๋ด์ฉ์ ์๋์ผ๋ก ์ ๋ฆฌํฉ๋๋ค. ์ด ์ต์
์ ๊ธฐ๋ณธ์ผ๋ก ์ผ์ ธ ์์ต๋๋ค. ์
์ฑ ์น์ฌ์ดํธ๊ฐ AI์ ์ปจํ
์คํธ์ ์ง์๋ฅผ ๋ฃ๋ ๋ฐ ์ฌ์ฉํ ์ ์๋ ์จ๊ฒจ์ง ๋ด์ฉ์ ์ ๊ฑฐํฉ๋๋ค.
- ์์๋ฅผ ์จ๊ธฐ๋ ์ธ๋ผ์ธ ์คํ์ผ:
display:none,visibility:hidden, ๋ถํฌ๋ช ๋, ๊ธ๊ผด ํฌ๊ธฐ, ๋์ด, ๋๋น, ์ต๋ ๋์ด, ์ต๋ ๋๋น์ ๊ฐ์ด 0์ธ ์คํ์ผ - ์ ๊ทผ์ฑ ๋๊ตฌ์์ ์จ๊ธด ์์:
aria-hidden="true" - ํ
ํ๋ฆฟ ํ๊ทธ์ ์จ๊ฒจ์ง ์ฌ๋กฏ:
<template>,<slot hidden>์์ - HTML ์ฃผ์:
<!-- ... --> - ๋๋น๊ฐ 0์ธ ๋ฌธ์: ๋๋น๊ฐ 0์ธ ๊ณต๋ฐฑ์ฒ๋ผ ๋์ ๋ณด์ด์ง ์๋ ์ ๋์ฝ๋ ๋ฌธ์
์ด ๋ณดํธ ๊ธฐ๋ฅ์ HTML, Markdown, ํ
์คํธ ์ถ์ถ์ ์๋์ผ๋ก ์ ์ฉ๋ฉ๋๋ค. ์ต๋ํ ๋ณดํธํ๋ ค๋ฉด ๊ธฐ๋ณธ๊ฐ์ธ main_content_only=true๋ฅผ ์ ์งํ์ธ์.
6. ์ธ์ ๊ด๋ฆฌํ๊ธฐ {#6-manage-sessions}
- ํ ๋ฒ๋ง ๊ฐ์ ธ์ฌ ๋๋
make_request๋browser_fetch_once๋ฅผ ์ฌ์ฉํ์ธ์. ๋ ๋๊ตฌ๋ ๋ฆฌ์์ค๋ฅผ ์ง์ ์ ๋ฆฌํ๋ฉฐ, ๋ค์ ํธ์ถ์ ์ฌ์ฉํ ์ธ์ ์ ๋จ๊ธฐ์ง ์์ต๋๋ค. - ์ฌ๋ฌ ํ์ด์ง๋ฅผ ์คํฌ๋ํํ ๋๋
browser_open์ผ๋ก ์ง์ ๋ธ๋ผ์ฐ์ ์ธ์ ์ ๋ง๋ค๊ณ , ๊ฐ์ ์ธ์ ์์ ๊ฐ ํ์ด์ง์ ๋ํดbrowser_fetch๋ฅผ ํธ์ถํ์ธ์. - ์ผ๋ฐ HTTP ์์ฒญ์ ์ฌ๋ฌ ๋ฒ ๋ณด๋ผ ๋๋
open_request_session์ ์ฌ์ฉํ๊ณ , ์์ฒญ๋ง๋คsession_make_request๋ฅผ ํธ์ถํ์ธ์. ๋ธ๋ผ์ฐ์ ์์ด๋ ํธ์ถ ์ฌ์ด์ ์ฟ ํค, ์ฐ๊ฒฐ, ๋ธ๋ผ์ฐ์ ์ง๋ฌธ(impersonate)์ ์ ์งํฉ๋๋ค. - ์ธ์
์ ์ด ๋ ์ง์ ํ ์ธ์
์ค์ ์ ์ ์งํฉ๋๋ค. ๋ธ๋ผ์ฐ์ ์์๋ headless, locale, cookies, ์คํ
์ค ์ต์
๋ฑ์ด ํด๋นํ๊ณ , ์์ฒญ ์ธ์
์์๋
impersonate,proxy๊ฐ ํด๋นํฉ๋๋ค. timeout, wait_selector, network_idle, solve_cloudflare ๊ฐ์ ์์ฒญ๋ณ ์ต์ ์browser_fetch/session_make_request๋ฅผ ํธ์ถํ ๋๋ง๋ค ์ ๋ฌํฉ๋๋ค. ๊ธฐ๋ณธ๊ฐ์ ๊ฐ ๋๊ตฌ์ ์คํค๋ง์ ๋์ ์์ต๋๋ค. browser_fetch๋ ์ด๋ ค ์๋ ์คํ ์ค ๋ธ๋ผ์ฐ์ ์ธ์ ์์ Cloudflare ๊ฒ์ฆ์ ํต๊ณผํ ์ ์์ต๋๋ค.- ์์
์ด ๋๋๋ฉด ํญ์
close_session์ผ๋ก ์ธ์ ์ ๋ซ์ ๋ฆฌ์์ค๋ฅผ ํด์ ํ์ธ์. list_sessions๋ก ์์ง ํ์ฑ ์ํ์ธ ์ธ์ ๊ณผ ์์ฑํ ๋ ์ฌ์ฉํsettings๋ฅผ ํ์ธํ์ธ์. ์ด ์ ๋ณด๋ AI ์์ด์ ํธ์ ๋ฐํ๋๋ฉฐ, CDP ์ธ์ ์์๋ ๋น์ด ์์ต๋๋ค.- ์ธ์
์ ์ฌ๋ ๋๊ตฌ์ ์ํ๋
session_id๋ฅผ ์ ๋ฌํ๋ฉด ๊ธฐ๋ณธ๊ฐ์ธ ์์์ 16์ง์ ๋์ ์๋ฏธ ์๋ ์ด๋ฆ(์:"search","checkout")์ ๋ถ์ผ ์ ์์ต๋๋ค. ์ด๋ฏธ ์ฌ์ฉ ์ค์ธ ID๋ฅผ ์ง์ ํ๋ฉด ์ค๋ฅ๊ฐ ๋ฐ์ํ๋ฏ๋ก ์ด๋ฆ ์ถฉ๋์ ๋ฐ๋ก ์ ์ ์์ต๋๋ค.
7. ์คํฌ๋ฆฐ์ท ์ฐ๊ธฐ {#7-capturing-screenshots}
browser_screenshot์ ์คํ ์ค ๋ธ๋ผ์ฐ์ ์ธ์ ์์browser_fetch๋ก ์ด๋ฏธ ์ฐ ํ์ด์ง๋ฅผ ์บก์ฒํฉ๋๋ค. ํ์ด์ง๋ฅผ ๋ค์ ๋ก๋ํ์ง ์์ผ๋ฏ๋ก AI๊ฐ ์ ๋ ฅํ ํ๋, ์ด๋ฆฐ ๋ฉ๋ด ๋ฑ ์์ ๊ฒฐ๊ณผ๋ฅผ ํ์ธํ ์ ์์ต๋๋ค.- ์ด๋ฏธ์ง๋ ์ค์
ImageContent๋ธ๋ก์ผ๋ก ๋ฐํ๋๋ฏ๋ก ๋ชจ๋ธ์ด ํ์ด์ง๋ฅผ ์ง์ ๋ณผ ์ ์์ต๋๋ค. - ํ์ฌ ๋ณด์ด๋ ํ๋ฉด์ด๋ ์๋์ชฝ์ ๋ณด์ด์ง ์๋ ๋ด์ฉ๊น์ง ํฌํจํ ์ ์ฒด ํ์ด์ง๋ฅผ ์บก์ฒํ ์ ์์ต๋๋ค.
- ํ๋, ์ฐจํธ, ์นด๋, ๊ฒฐ๊ณผ ํ๋๋ง ์บก์ฒํด ์ฃผ๋ณ ๋ด์ฉ์ ์ค์ผ ์ ์์ต๋๋ค. ์์๋ฅผ ์บก์ฒํ ๋๋ ๋์์ด ๋ณด์ด๋๋ก ์คํฌ๋กคํ ์ ์์ต๋๋ค.
- ์์ค ์๋ ์ด๋ฏธ์ง์๋ PNG๋ฅผ, ๋ ์์ ์ ์ก ํฌ๊ธฐ์๋ ํ์ง์ ์กฐ์ ํ ์ ์๋ JPEG๋ฅผ ์ ํํ์ธ์.
- AI๋ ์บก์ฒ ์ ์
browser_actions๋ก ์ฝํ ์ธ ๋ฅผ ๊ธฐ๋ค๋ฆฌ๊ฑฐ๋ ํ์ํ ์กฐ์์ ๋ง์น ์ ์์ต๋๋ค.
๋ฒ์ ์ฌํญ๊ณผ ์ค๋ฆฌ {#legal-and-ethical-considerations}
โ ๏ธ ์ค์ํ ์ง์นจ:
- robots.txt ํ์ธ:
https://website.com/robots.txt์์ ์คํฌ๋ํ ๊ท์น์ ํ์ธํ์ธ์. - ์์ฒญ ์๋ ์ ํ ์ค์: ๋๋ฌด ๋ง์ ์์ฒญ์ผ๋ก ์๋ฒ์ ๋ถ๋ด์ ์ฃผ์ง ๋ง์ธ์.
- ์ด์ฉ ์ฝ๊ด: ์น์ฌ์ดํธ์ ์ฝ๊ด์ ์ฝ๊ณ ์ค์ํ์ธ์.
- ์ ์๊ถ: ์ง์์ฌ์ฐ๊ถ์ ์กด์คํ์ธ์.
- ๊ฐ์ธ์ ๋ณด: ๊ฐ์ธ์ ๋ณด ๋ณดํธ๋ฒ์ ์ฃผ์ํ์ธ์.
- ์์ ์ ์ด์ฉ: ์ฌ์ ๋ชฉ์ ์ผ๋ก ์ด์ฉํ ๊ถํ์ด ์๋์ง ํ์ธํ์ธ์.
Scrapling ํ์ด โค๏ธ๋ฅผ ๋ด์ ๋ง๋ค์์ต๋๋ค. ์ฆ๊ฒ๊ฒ ์คํฌ๋ํํ์ธ์!