encarapi-mcp 1.2.0 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -6
- package/package.json +2 -2
- package/src/brand.js +2 -2
- package/src/server.js +5 -5
- package/src/stdio.js +1 -1
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# EnCarAPI MCP server: Korean and Chinese used car data for AI assistants
|
|
2
2
|
|
|
3
3
|
[Model Context Protocol](https://modelcontextprotocol.io) server for
|
|
4
|
-
[EnCarAPI](https://encarapi.com). Lets Claude, Cursor, ChatGPT and other MCP clients search
|
|
4
|
+
[EnCarAPI](https://encarapi.com/?utm_source=readme&utm_medium=encarapi-mcp). Lets Claude, Cursor, ChatGPT and other MCP clients search
|
|
5
5
|
**live used car listings from South Korea** (Encar, KB Chachacha, K Car) and **China**
|
|
6
6
|
(Dongchedi, Che168), and pull full details, inspection reports and accident records.
|
|
7
7
|
|
|
8
|
-
> **An API key is required.** Get one (5-day trial) at [encarapi.com](https://encarapi.com).
|
|
9
|
-
> Chinese data works with a [ChinaCarAPI](https://chinacarapi.com) key or an EnCarAPI key
|
|
8
|
+
> **An API key is required.** Get one (5-day trial) at [encarapi.com](https://encarapi.com/?utm_source=readme&utm_medium=encarapi-mcp).
|
|
9
|
+
> Chinese data works with a [ChinaCarAPI](https://chinacarapi.com/?utm_source=readme&utm_medium=encarapi-mcp) key or an EnCarAPI key
|
|
10
10
|
> with the China add-on. ChinaCarAPI customers: see [For ChinaCarAPI customers](#for-chinacarapi-customers).
|
|
11
11
|
|
|
12
12
|
## Tools
|
|
@@ -50,7 +50,7 @@ claude mcp add --transport http encarapi https://mcp.encarapi.com/mcp
|
|
|
50
50
|
|
|
51
51
|
The key is checked once and is not stored on the server: it is encrypted into the token
|
|
52
52
|
your client receives. To disconnect, remove the server in your client; to cut off access
|
|
53
|
-
everywhere, rotate your key at [encarapi.com](https://encarapi.com).
|
|
53
|
+
everywhere, rotate your key at [encarapi.com](https://encarapi.com/?utm_source=readme&utm_medium=encarapi-mcp).
|
|
54
54
|
|
|
55
55
|
### Alternative: send the key yourself
|
|
56
56
|
|
|
@@ -181,8 +181,8 @@ self-contained values (AES-256-GCM) that carry the key. Consequences:
|
|
|
181
181
|
|
|
182
182
|
## Links
|
|
183
183
|
|
|
184
|
-
- EnCarAPI: https://encarapi.com
|
|
185
|
-
- ChinaCarAPI: https://chinacarapi.com
|
|
184
|
+
- EnCarAPI: [encarapi.com](https://encarapi.com/?utm_source=readme&utm_medium=encarapi-mcp)
|
|
185
|
+
- ChinaCarAPI: [chinacarapi.com](https://chinacarapi.com/?utm_source=readme&utm_medium=encarapi-mcp)
|
|
186
186
|
- SDKs: [Node.js](https://github.com/ThatMojo/encarapi-node), [Python](https://github.com/ThatMojo/encarapi-python)
|
|
187
187
|
|
|
188
188
|
EnCarAPI is an independent service and not affiliated with Encar, KB Chachacha, K Car,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "encarapi-mcp",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.1",
|
|
4
4
|
"description": "MCP server for EnCarAPI and ChinaCarAPI: live Korean (Encar, KB Chachacha, K Car) and Chinese (Dongchedi, Che168) used car listings for Claude, Cursor and other AI assistants.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "src/server.js",
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"claude",
|
|
35
35
|
"cursor"
|
|
36
36
|
],
|
|
37
|
-
"homepage": "https://encarapi.com",
|
|
37
|
+
"homepage": "https://encarapi.com/?utm_source=npm&utm_medium=encarapi-mcp",
|
|
38
38
|
"repository": {
|
|
39
39
|
"type": "git",
|
|
40
40
|
"url": "git+https://github.com/ThatMojo/encarapi-mcp.git"
|
package/src/brand.js
CHANGED
|
@@ -7,7 +7,7 @@ export const BRANDS = {
|
|
|
7
7
|
id: "korea",
|
|
8
8
|
product: "EnCarAPI",
|
|
9
9
|
otherProduct: "ChinaCarAPI",
|
|
10
|
-
signupUrl: "https://encarapi.com",
|
|
10
|
+
signupUrl: "https://encarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=signin#pricing",
|
|
11
11
|
signupText: "https://encarapi.com",
|
|
12
12
|
resourceName: "EnCarAPI MCP server",
|
|
13
13
|
// Form field names: the main field is auto-detected, the second one is for a
|
|
@@ -20,7 +20,7 @@ export const BRANDS = {
|
|
|
20
20
|
id: "china",
|
|
21
21
|
product: "ChinaCarAPI",
|
|
22
22
|
otherProduct: "EnCarAPI",
|
|
23
|
-
signupUrl: "https://chinacarapi.com
|
|
23
|
+
signupUrl: "https://chinacarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=signin#pricing",
|
|
24
24
|
signupText: "chinacarapi.com",
|
|
25
25
|
resourceName: "ChinaCarAPI MCP server",
|
|
26
26
|
mainField: "chinacarapi_key",
|
package/src/server.js
CHANGED
|
@@ -4,7 +4,7 @@ import encarapi from "encarapi";
|
|
|
4
4
|
|
|
5
5
|
const { KoreaClient, ChinaClient } = encarapi;
|
|
6
6
|
|
|
7
|
-
export const VERSION = "1.2.
|
|
7
|
+
export const VERSION = "1.2.1";
|
|
8
8
|
const MAX_TEXT = 40000;
|
|
9
9
|
|
|
10
10
|
const asText = (data) => {
|
|
@@ -92,7 +92,7 @@ const SERVER_INFO = {
|
|
|
92
92
|
"Live used car listings from South Korea (Encar, KB Chachacha, K Car) and China (Dongchedi, Che168). " +
|
|
93
93
|
"Korean prices are in KRW, Chinese prices in CNY with USD/EUR conversions. " +
|
|
94
94
|
"Use find_korean_models or korean_filter_values to get exact names before filtering. " +
|
|
95
|
-
"Requires an API key from https://encarapi.com (China: https://chinacarapi.com).",
|
|
95
|
+
"Requires an API key from https://encarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=instructions (China: https://chinacarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=instructions).",
|
|
96
96
|
},
|
|
97
97
|
china: {
|
|
98
98
|
info: { name: "chinacarapi", title: "ChinaCarAPI - Chinese & Korean used car data", version: VERSION },
|
|
@@ -101,7 +101,7 @@ const SERVER_INFO = {
|
|
|
101
101
|
"Chinese prices are in CNY with USD/EUR conversions, Korean prices in KRW. " +
|
|
102
102
|
"Use chinese_filter_values (makes, fuels, cities) and chinese_models to get exact values before filtering " +
|
|
103
103
|
"search_chinese_cars; for Korea use find_korean_models or korean_filter_values. " +
|
|
104
|
-
"Requires an API key from https://chinacarapi.com (Korea: https://encarapi.com).",
|
|
104
|
+
"Requires an API key from https://chinacarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=instructions (Korea: https://encarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=instructions).",
|
|
105
105
|
},
|
|
106
106
|
};
|
|
107
107
|
|
|
@@ -119,11 +119,11 @@ export function createServer({ apiKey, chinaKey, fetchImpl, transport = "stdio",
|
|
|
119
119
|
const korea = apiKey ? new KoreaClient(apiKey, { fetch: fetchImpl }) : null;
|
|
120
120
|
const china = chinaKey || apiKey ? new ChinaClient(chinaKey || apiKey, { fetch: fetchImpl }) : null;
|
|
121
121
|
const needKorea = () => {
|
|
122
|
-
if (!korea) throw new Error("No EnCarAPI key configured (ENCARAPI_KEY). Get one at https://encarapi.com");
|
|
122
|
+
if (!korea) throw new Error("No EnCarAPI key configured (ENCARAPI_KEY). Get one at https://encarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=error");
|
|
123
123
|
return korea;
|
|
124
124
|
};
|
|
125
125
|
const needChina = () => {
|
|
126
|
-
if (!china) throw new Error("No ChinaCarAPI key configured (CHINACARAPI_KEY). Get one at https://chinacarapi.com");
|
|
126
|
+
if (!china) throw new Error("No ChinaCarAPI key configured (CHINACARAPI_KEY). Get one at https://chinacarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=error");
|
|
127
127
|
return china;
|
|
128
128
|
};
|
|
129
129
|
const run = (fn) => async (args) => {
|
package/src/stdio.js
CHANGED
|
@@ -7,7 +7,7 @@ const chinaKey = process.env.CHINACARAPI_KEY;
|
|
|
7
7
|
|
|
8
8
|
if (!apiKey && !chinaKey) {
|
|
9
9
|
console.error(
|
|
10
|
-
"encarapi-mcp: set ENCARAPI_KEY (Korea, https://encarapi.com) and/or CHINACARAPI_KEY (China, https://chinacarapi.com)."
|
|
10
|
+
"encarapi-mcp: set ENCARAPI_KEY (Korea, https://encarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=error) and/or CHINACARAPI_KEY (China, https://chinacarapi.com/?utm_source=mcp&utm_medium=encarapi-mcp&utm_content=error)."
|
|
11
11
|
);
|
|
12
12
|
process.exit(1);
|
|
13
13
|
}
|