@kiyeonjeon21/ncli 0.1.12 → 0.1.13

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.
Files changed (3) hide show
  1. package/package.json +1 -1
  2. package/skills/datalab.md +33 -14
  3. package/skills/search.md +40 -10
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kiyeonjeon21/ncli",
3
- "version": "0.1.12",
3
+ "version": "0.1.13",
4
4
  "description": "Agent-native CLI for Naver Open APIs",
5
5
  "type": "module",
6
6
  "bin": {
package/skills/datalab.md CHANGED
@@ -1,9 +1,14 @@
1
1
  ---
2
- name: naver-datalab
3
- description: Rules and patterns for using naver CLI DataLab APIs. Use when analyzing search trends or shopping insights.
2
+ name: ncli-datalab
3
+ version: 1.0.0
4
+ description: Rules and patterns for using ncli DataLab APIs. Use when analyzing search trends or shopping insights.
5
+ metadata:
6
+ openclaw:
7
+ requires:
8
+ bins: ["ncli"]
4
9
  ---
5
10
 
6
- # naver datalab Operations
11
+ # ncli datalab Operations
7
12
 
8
13
  ## Rules
9
14
 
@@ -11,8 +16,10 @@ description: Rules and patterns for using naver CLI DataLab APIs. Use when analy
11
16
  2. Always use `--output json` for output
12
17
  3. Rate limit is 1,000 calls/day — use sparingly
13
18
  4. Date format is `yyyy-mm-dd`
14
- 5. `timeUnit` must be one of: `date`, `week`, `month`
15
- 6. Maximum 5 keyword groups per request
19
+ 5. `endDate` must not be in the future
20
+ 6. `timeUnit` must be one of: `date`, `week`, `month`
21
+ 7. Maximum 5 keyword groups per request
22
+ 8. Always use `--dry-run` to validate before executing
16
23
 
17
24
  ## Authentication
18
25
 
@@ -26,13 +33,13 @@ export NAVER_CLIENT_SECRET="your-client-secret"
26
33
  ### Search keyword trend
27
34
 
28
35
  ```bash
29
- naver datalab trend --json '{
36
+ ncli datalab trend --json '{
30
37
  "startDate": "2026-01-01",
31
38
  "endDate": "2026-04-01",
32
39
  "timeUnit": "month",
33
40
  "keywordGroups": [
34
41
  {"groupName": "AI", "keywords": ["artificial intelligence", "AI"]},
35
- {"groupName": "blockchain", "keywords": ["blockchain", "blockchain"]}
42
+ {"groupName": "blockchain", "keywords": ["blockchain"]}
36
43
  ]
37
44
  }'
38
45
  ```
@@ -40,7 +47,7 @@ naver datalab trend --json '{
40
47
  ### Shopping category trend
41
48
 
42
49
  ```bash
43
- naver datalab shopping --json '{
50
+ ncli datalab shopping --json '{
44
51
  "startDate": "2026-01-01",
45
52
  "endDate": "2026-04-01",
46
53
  "timeUnit": "month",
@@ -53,7 +60,7 @@ naver datalab shopping --json '{
53
60
  ### With filters
54
61
 
55
62
  ```bash
56
- naver datalab trend --json '{
63
+ ncli datalab trend --json '{
57
64
  "startDate": "2026-01-01",
58
65
  "endDate": "2026-04-01",
59
66
  "timeUnit": "week",
@@ -64,17 +71,29 @@ naver datalab trend --json '{
64
71
  }'
65
72
  ```
66
73
 
74
+ ### Dry-run validation
75
+
76
+ ```bash
77
+ ncli --dry-run datalab trend --json '{
78
+ "startDate": "2026-01-01",
79
+ "endDate": "2026-04-01",
80
+ "timeUnit": "month",
81
+ "keywordGroups": [{"groupName": "test", "keywords": ["test"]}]
82
+ }'
83
+ ```
84
+
67
85
  ## Schema Introspection
68
86
 
69
87
  ```bash
70
- naver schema datalab.trend
71
- naver schema datalab.shopping
88
+ ncli schema datalab.trend
89
+ ncli schema datalab.shopping
90
+ ncli datalab trend --describe
72
91
  ```
73
92
 
74
93
  ## Error Handling
75
94
 
76
95
  | Error Code | Meaning | Action |
77
96
  |------------|---------|--------|
78
- | `AUTH_REQUIRED` | Missing credentials | Set environment variables |
79
- | `HTTP_400` | Bad request | Check required fields: startDate, endDate, timeUnit, keywordGroups/category |
80
- | `HTTP_429` | Rate limited (1,000/day) | This is a hard daily limit — plan queries carefully |
97
+ | `AUTH_REQUIRED` | Missing credentials | Run `ncli init` or set environment variables |
98
+ | `HTTP_400` | Bad request (e.g. future endDate) | Check required fields and date constraints |
99
+ | `HTTP_429` | Rate limited (1,000/day) | Hard daily limit — plan queries carefully |
package/skills/search.md CHANGED
@@ -1,9 +1,14 @@
1
1
  ---
2
- name: naver-search
3
- description: Rules and patterns for using naver CLI to search Naver services. Use when searching blog, news, web, image, book, cafe, kin, encyclopedia, or shop.
2
+ name: ncli-search
3
+ version: 1.0.0
4
+ description: Rules and patterns for using ncli to search Naver services. Use when searching blog, news, web, image, book, cafe, kin, encyclopedia, shop, local, errata, adult, or doc.
5
+ metadata:
6
+ openclaw:
7
+ requires:
8
+ bins: ["ncli"]
4
9
  ---
5
10
 
6
- # naver search Operations
11
+ # ncli search Operations
7
12
 
8
13
  ## Rules
9
14
 
@@ -14,8 +19,11 @@ description: Rules and patterns for using naver CLI to search Naver services. Us
14
19
  - news: `title,link,description,pubDate`
15
20
  - shop: `title,link,lprice,mallName,brand`
16
21
  - book: `title,author,publisher,isbn,description`
22
+ - local: `title,address,roadAddress,telephone`
17
23
  4. Use `--json` for complex queries with multiple parameters
18
24
  5. Use `--sanitize` when response data will be injected into agent context
25
+ 6. Use `--page-all --max-results N` for bulk retrieval
26
+ 7. Always use `--dry-run` before mutating operations
19
27
 
20
28
  ## Authentication
21
29
 
@@ -29,38 +37,60 @@ export NAVER_CLIENT_SECRET="your-client-secret"
29
37
  ### Quick search
30
38
 
31
39
  ```bash
32
- naver search blog "keyword" --fields "title,link,description"
40
+ ncli search blog "AI" --fields "title,link,description"
33
41
  ```
34
42
 
35
43
  ### Paginated search
36
44
 
37
45
  ```bash
38
46
  # Page 1
39
- naver search news "AI" --display 10 --start 1 --fields "title,link,pubDate"
47
+ ncli search news "AI" --display 10 --start 1 --fields "title,link,pubDate"
40
48
 
41
49
  # Page 2
42
- naver search news "AI" --display 10 --start 11 --fields "title,link,pubDate"
50
+ ncli search news "AI" --display 10 --start 11 --fields "title,link,pubDate"
51
+
52
+ # Auto-paginate
53
+ ncli search blog "AI" --page-all --max-results 50 --output ndjson --fields "title,link"
43
54
  ```
44
55
 
45
56
  ### JSON payload
46
57
 
47
58
  ```bash
48
- naver search shop --json '{"query":"macbook","display":5,"sort":"dsc"}' \
59
+ ncli search shop --json '{"query":"macbook","display":5,"sort":"dsc"}' \
49
60
  --fields "title,lprice,hprice,mallName"
50
61
  ```
51
62
 
63
+ ### Stdin input
64
+
65
+ ```bash
66
+ echo '{"query":"AI","display":3}' | ncli search blog --json - --fields "title,link"
67
+ ```
68
+
69
+ ### Utility searches
70
+
71
+ ```bash
72
+ # Spell check
73
+ ncli search errata "typo check"
74
+
75
+ # Adult content detection
76
+ ncli search adult "keyword"
77
+
78
+ # Local places
79
+ ncli search local "Gangnam restaurant" --fields "title,address,telephone"
80
+ ```
81
+
52
82
  ## Schema Introspection
53
83
 
54
84
  ```bash
55
- naver schema search.blog
56
- naver schema search.shop
85
+ ncli schema search.blog
86
+ ncli search blog --describe
57
87
  ```
58
88
 
59
89
  ## Error Handling
60
90
 
61
91
  | Error Code | Meaning | Action |
62
92
  |------------|---------|--------|
63
- | `AUTH_REQUIRED` | Missing credentials | Set environment variables |
93
+ | `AUTH_REQUIRED` | Missing credentials | Run `ncli init` or set environment variables |
64
94
  | `HTTP_400` | Bad request | Check schema for valid parameters |
65
95
  | `HTTP_429` | Rate limited (25,000/day) | Wait and retry |
66
96
  | `MISSING_QUERY` | No query provided | Add query argument |