# Encar 韓國中古車爬蟲｜二手車價格、里程、車廠一鍵匯出（免 API） (`claude_code_reviewer/encar-scraper`) Actor

免登入抓 Encar（엔카）韓國中古車：車廠、車型、年份、里程、韓元價格、燃料、賣家地區與認證徽章，英文或韓文廠牌皆可，可篩國產／進口，輸出 JSON／CSV／Excel。韓國車行情、跨境車商選車必備。

- **URL**: https://apify.com/claude\_code\_reviewer/encar-scraper.md
- **Developed by:** [Chad](https://apify.com/claude_code_reviewer) (community)
- **Categories:** Automation, E-commerce, Developer tools
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 中古車搜尋

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Encar 韓國中古車爬蟲｜二手車價格、里程、車廠一鍵下載（免 API）

抓 **Encar（엔카）** 韓國最大中古車平台搜尋列表：車廠、車型、年份、里程、價格（韓元）、燃料、賣家地區與 Encar 認證徽章。走 Encar 公開 JSON API，**不用登入、不用 API key、不用 token**。輸入英文或韓文廠牌、或留空抓全站最新上架，輸出乾淨的 snake\_case 結構化資料（JSON / CSV / Excel）。

適合：跨境車商選車、韓國中古車行情分析、車價比較、進口車採購情報、市場監控。

***

### 輸出欄位

| 欄位 | 說明 |
|---|---|
| `car_id` | 車輛 ID，主鍵 |
| `manufacturer` | 車廠（韓文，如 현대、기아、BMW）|
| `origin` | 車籍：`domestic`（國產）/ `import`（進口）/ `null`（未收錄廠牌）|
| `model` | 車型，如 `올 뉴 K3` |
| `badge` | 等級／配備線，如 `프레스티지` |
| `fuel_type` | 燃料，如 `가솔린`（汽油）、`디젤`、`LPG`、`전기` |
| `year` | 出廠年份（YYYY）|
| `year_month` | 首次登記年月（YYYYMM），如 `201804` |
| `mileage_km` | 里程（公里）|
| `price_manwon` | 售價（萬元韓元，Encar 原生單位）|
| `price_krw` | 售價（韓元，= price\_manwon × 10000）|
| `sell_type` | 銷售型態，如 `일반`（一般）、`리스`（租賃）、`렌트` |
| `region` | 賣家所在地區，如 `경기`、`부산` |
| `trust` | 保固／服務徽章陣列，如 `["ExtendWarranty","HomeService"]` |
| `service_mark` | Encar 服務標記陣列，如 `["EncarDiagnosisP1"]` |
| `condition` | 車況徽章陣列，如 `["Inspection","Record","Resume"]` |
| `image_url` | 首張車圖 |
| `image_count` | 圖片張數 |
| `url` | 車輛詳情頁連結 |
| `source_mode` | 來源模式 |
| `source_query` | 對應的車廠關鍵字（留空＝全站）|
| `scraped_at` | 抓取時間（ISO 8601）|

> 缺值一律補 `null`，欄位不省略。價格以 Encar 顯示為準（未含稅費）。

### 模式

| 模式 | 說明 | 狀態 |
|---|---|---|
| `search`（搜尋） | 車廠 → 中古車列表 | ✅ v1.0 |
| `detail`（詳情） | 車輛 ID → 完整規格、事故／扣押紀錄、VIN、車牌、全照片、賣家聯絡 | ✅ v1.1 |

#### 詳情模式（v1.1）

輸入 `mode: "detail"` + `carIds`（車輛 ID 清單，通常來自搜尋輸出的 `car_id`），每筆 **$0.008**，回傳比列表更完整的欄位：

```json
{ "mode": "detail", "carIds": ["42063226", "41871403"] }
```

新增欄位：`vin`、`vehicle_no`（車牌）、`grade`/`grade_en`（等級）、`displacement_cc`、`transmission`、`color`、`seat_count`、`body_type`、`origin_price_manwon`（新車價）、`accident_record_available`／`resume_record_available`（事故／使用紀錄有無）、`seizure_count`／`pledge_count`（압류/저당，0=乾淨）、`is_diagnosis_car`、`seller_type`／`seller_id`／`seller_address`／`seller_phone`、`view_count`／`subscribe_count`、`image_urls`（全部照片）、`option_codes`、`description`（賣家描述）。

### 輸入參數

| 參數 | 型別 | 說明 | 預設 |
|---|---|---|---|
| `keywords` | 陣列 | 車廠（英文或韓文，如 Hyundai／현대）。留空＝全站最新上架 | — |
| `carType` | 選單 | 車籍 all／domestic 국산／import 수입（只在留空車廠時生效）| `all` |
| `bulkInput` | 文字 | 一行一個車廠，自動併入 | — |
| `maxItems` | 整數 | **每個車廠**上限（1–500）| `50` |
| `proxyConfiguration` | Proxy | 預設不用 proxy；被擋時再開 | 關閉 |

### 輸入範例

**1. 抓現代（Hyundai）前 10 筆**

```json
{ "keywords": ["Hyundai"], "maxItems": 10 }
```

**2. 全站最新進口車 15 筆**

```json
{ "carType": "import", "maxItems": 15 }
```

**3. 批量多廠牌（Genesis / BMW / Tesla）**

```json
{ "bulkInput": "Genesis\nBMW\nTesla", "maxItems": 10 }
```

**4. 用韓文廠牌抓起亞（Kia）**

```json
{ "keywords": ["기아"], "maxItems": 20 }
```

### 注意事項

- **車廠可用英文或韓文**：內建英↔韓對照（Hyundai↔현대、Benz↔벤츠、KGM↔KG모빌리티(쌍용)…），未收錄的廠牌會原樣送出（在全車籍下搜尋）。
- **`carType` 只在留空車廠時生效**：指定車廠時，車籍由該廠牌自動判定（國產廠牌自動走 국산、進口廠牌自動走 수입），避免「現代＋進口」抓到 0 筆的組合。
- **價格是韓元**：`price_manwon` 是 Encar 原生單位（萬元韓元），`price_krw` 已換算成韓元方便使用。
- **`maxItems` 是每個車廠**：3 個車廠 × 50 = 最多 150 筆。同一車輛在兩個查詢都出現時只輸出一次。
- **車型（Model）過濾**：Encar 的車型欄位是精確字串（如 `올 뉴 K3`）、易誤判，v1.0 先不開放，規劃於 v1.1 詳情模式一併處理。
- **列表為快照**：以實際 Encar 頁面為準。

### FAQ

**Q：需要 Encar 帳號或 API key 嗎？**
不用。只抓公開搜尋結果，無需登入或 token。

**Q：抓得到進口車嗎？**
可以。輸入 BMW、Benz、Audi、Tesla 等（英文或韓文皆可），或用 `carType: "import"` 抓全站進口車。

**Q：價格單位是什麼？**
`price_krw` 是韓元（KRW）。`price_manwon` 保留 Encar 原生的「萬元」單位。

**Q：抓得到車輛完整規格、事故紀錄嗎？**
搜尋模式提供列表結構化欄位；完整規格、配備與事故／保養紀錄將於 detail 模式（v1.1）推出。

**Q：怎麼計費？**
分項計費（PPE）：啟動一次 $0.005 + 中古車每筆 $0.002。只有成功寫入資料後才計費。

### 免責聲明

本工具僅抓取 Encar 公開可見的中古車刊登資訊，供市場研究與資料分析之用。使用者應遵守 Encar 服務條款及當地法律，自行負責資料的使用方式。本工具不蒐集任何需登入才能存取的私人資料。車輛內容與價格以網站實際顯示為準。

***

*關鍵字：Encar 爬蟲、Encar scraper、엔카、韓國中古車、韓國二手車、中古車價格、進口車採購、車商選車、韓國車行情、used car Korea、Korea used car data、car price scraper、中古車數據、跨境車商、車價比較*

# Actor input Schema

## `mode` (type: `string`):

搜尋列表（車廠→列表）或詳情（車輛 ID→完整規格、事故／扣押紀錄、賣家聯絡）。

## `carIds` (type: `array`):

詳情模式用：車輛 ID 清單（搜尋輸出的 car\_id）。每筆計費 $0.008，回傳完整規格、事故／扣押紀錄、VIN、車牌、全部照片、賣家聯絡與描述。也可用下方批量貼上一行一個 ID。

## `keywords` (type: `array`):

車廠關鍵字，可用英文或韓文，例如：Hyundai、Kia、Genesis、BMW、Benz、Tesla，或 현대、기아。留空則抓全站最新上架（不篩車廠）。內建英↔韓對照，車型（如 K5）過濾規劃於 v1.1。

## `carType` (type: `string`):

只在「留空車廠」抓全站時生效（指定車廠時車籍由車廠自動判定）。

## `bulkInput` (type: `string`):

**一行一個**，按 Enter 換行，不要加引號或逗號。搜尋模式併入車廠欄位；詳情模式併入車輛 ID。

## `maxItems` (type: `integer`):

每個車廠（或整體不篩選搜尋）最多抓幾筆。越多費用越高。

## `proxyConfiguration` (type: `object`):

預設走 Apify datacenter proxy：不用 proxy 時會跟平台上其他 run 共用出口 IP，而 Encar 已經擋掉那個共用 IP——請求會回 200 但沒有資料（實測：無 proxy 0 筆、datacenter proxy 20 筆）。JSON 回應很小，proxy 流量費可忽略。自備 proxy 或本機測試才關掉。

## Actor input object example

```json
{
  "mode": "search",
  "keywords": [
    "Hyundai"
  ],
  "carType": "all",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `dataset` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "keywords": [
        "Hyundai"
    ],
    "carType": "all"
};

// Run the Actor and wait for it to finish
const run = await client.actor("claude_code_reviewer/encar-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "keywords": ["Hyundai"],
    "carType": "all",
}

# Run the Actor and wait for it to finish
run = client.actor("claude_code_reviewer/encar-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "keywords": [
    "Hyundai"
  ],
  "carType": "all"
}' |
apify call claude_code_reviewer/encar-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,claude_code_reviewer/encar-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/y9gIJCc7ti47hM9J5/builds/deQUN6CB3W2ukDN91/openapi.json