# Naver Search Intelligence (`truenorth/naver-search-intelligence`) Actor Bulk normalized Naver SERP extraction across major verticals. - **URL**: https://apify.com/truenorth/naver-search-intelligence.md - **Developed by:** [TrueNorth](https://apify.com/truenorth) (community) - **Categories:** SEO tools, News - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.80 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Naver Search Intelligence TypeScript Apify Actor extracting normalized Naver search results for bulk queries. Supported verticals: `integrated`, `web`, `news`, `blog-cafe`, `shopping`, and `knowledge`. ### Input ```json { "queries": ["Samsung", "인공지능"], "verticals": ["integrated", "news", "shopping"], "maxResultsPerQuery": 100, "maxPages": 10, "proxyConfiguration": { "useApifyProxy": true }, "maxRetries": 3, "retryBaseDelayMs": 1000 } ```` `maxResultsPerQuery` caps combined output across selected verticals for each query. Results retain requested vertical and detected SERP section. Duplicate URL/title pairs are removed. For deterministic local parsing, set `fixtureHtmlPath`. Fixture mode reads one local HTML file, performs no HTTP requests, and processes only first page for each query/vertical combination. ```json { "queries": ["인공지능"], "verticals": ["integrated"], "fixtureHtmlPath": "test/fixtures/naver-ai.html" } ``` ### Output Each default-dataset item always contains: `query`, `vertical`, `position`, `section`, `resultType`, `title`, `description`, `url`, `displayUrl`, `source`, `publishedAt`, `price`, `currency`, `isAd`, `scrapedAt`. Unavailable optional values use `null`; schema keys never disappear. `price` is numeric and captured Korean-won prices use `KRW`. `publishedAt` preserves Naver display text because SERPs can return relative times. Run summary is stored in key-value-store record `OUTPUT`. ### Local development Requires Node.js 20+ and pnpm. ```sh pnpm install --frozen-lockfile pnpm test pnpm build ``` Run through Apify CLI or provide `APIFY_INPUT_KEY`/local storage using standard Apify SDK conventions. `pnpm start` runs compiled `dist/main.js`. ### Reliability and limitations - Browser-like localized headers, Apify proxy support, bounded exponential retry/backoff, and visible blocked-page markers are included. - Naver changes markup frequently. Parser uses semantic block metadata plus selector fallbacks, backed by immutable captured fixtures. - SSR parsing cannot recover cards rendered only after client-side JavaScript or absent from response HTML. - Public endpoint needs no login. Restricted/personalized results are outside scope. - Respect Naver terms, robots rules, applicable law, and conservative request rates. # Actor input Schema ## `queries` (type: `array`): Search queries to process. ## `verticals` (type: `array`): Naver search scopes. ## `maxResultsPerQuery` (type: `integer`): Combined result cap across selected verticals. ## `maxPages` (type: `integer`): Page cap for each query and vertical. ## `proxyConfiguration` (type: `object`): Apify Proxy or custom proxy settings. ## `maxRetries` (type: `integer`): Maximum retry attempts after each failed request. ## `retryBaseDelayMs` (type: `integer`): Base delay in milliseconds used for exponential retry backoff. ## `fixtureHtmlPath` (type: `string`): Local deterministic test input that skips network requests. ## Actor input object example ```json { "verticals": [ "integrated" ], "maxResultsPerQuery": 100, "maxPages": 10, "maxRetries": 3, "retryBaseDelayMs": 1000 } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `output` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("truenorth/naver-search-intelligence").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("truenorth/naver-search-intelligence").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call truenorth/naver-search-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=truenorth/naver-search-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Naver Search Intelligence", "description": "Bulk normalized Naver SERP extraction across major verticals.", "version": "1.0", "x-build-id": "XlbRqwmXuRsMsjOzo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truenorth~naver-search-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truenorth-naver-search-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/truenorth~naver-search-intelligence/runs": { "post": { "operationId": "runs-sync-truenorth-naver-search-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/truenorth~naver-search-intelligence/run-sync": { "post": { "operationId": "run-sync-truenorth-naver-search-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "queries" ], "properties": { "queries": { "title": "Queries", "type": "array", "description": "Search queries to process.", "items": { "type": "string", "minLength": 1 } }, "verticals": { "title": "Verticals", "type": "array", "description": "Naver search scopes.", "items": { "type": "string", "enum": [ "integrated", "web", "news", "blog-cafe", "shopping", "knowledge" ], "enumTitles": [ "Integrated", "Web", "News", "Blog and Cafe", "Shopping", "Knowledge iN" ] }, "default": [ "integrated" ] }, "maxResultsPerQuery": { "title": "Maximum results per query", "minimum": 1, "type": "integer", "description": "Combined result cap across selected verticals.", "default": 100 }, "maxPages": { "title": "Maximum pages", "minimum": 1, "type": "integer", "description": "Page cap for each query and vertical.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or custom proxy settings." }, "maxRetries": { "title": "Maximum retries", "minimum": 1, "type": "integer", "description": "Maximum retry attempts after each failed request.", "default": 3 }, "retryBaseDelayMs": { "title": "Retry base delay", "minimum": 1, "type": "integer", "description": "Base delay in milliseconds used for exponential retry backoff.", "default": 1000 }, "fixtureHtmlPath": { "title": "Fixture HTML path", "type": "string", "description": "Local deterministic test input that skips network requests." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```