kaito-mcp-server 0.2.7 → 0.2.9
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.
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"advanced-search.d.ts","sourceRoot":"","sources":["../../src/tools/advanced-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,
|
|
1
|
+
{"version":3,"file":"advanced-search.d.ts","sourceRoot":"","sources":["../../src/tools/advanced-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAoMhF"}
|
|
@@ -10,12 +10,19 @@ DISCOVERY MODE: Omit all tokens/query/keyword/usernames for unfiltered trending
|
|
|
10
10
|
|
|
11
11
|
TIME RANGE: When the user specifies a time range (e.g. 'today', 'past week'), you MUST convert it to ISO 8601 timestamps and pass min_created_at / max_created_at accordingly.
|
|
12
12
|
|
|
13
|
+
TOKENS vs QUERY — WHEN TO USE EACH:
|
|
14
|
+
- When the user asks about a specific project and the token exists in kaito://tokens, prefer using tokens alone without query/keyword. The tokens parameter already scopes results to that entity.
|
|
15
|
+
- Only add query/keyword when the user wants a specific subtopic (e.g. "monad staking" → tokens=MONAD, query="staking").
|
|
16
|
+
- Do NOT repeat the project name in query when it is already in tokens — it adds noise without improving recall.
|
|
17
|
+
- Do NOT add generic filler words like "blockchain", "crypto", "news", or "protocol" to query. These dilute search precision.
|
|
18
|
+
- For major tickers (BTC, ETH, SOL) where the user wants a specific topic, pair tokens with query/keyword to narrow results. For a general feed on these tokens, tokens alone is still fine.
|
|
19
|
+
|
|
13
20
|
PRIMARY TEXT INPUT:
|
|
14
21
|
- Use ONE main text field per call: either query or keyword.
|
|
15
|
-
- query is the main user-facing field.
|
|
22
|
+
- query is the main user-facing field. It can be 1-6 high-signal words or a short phrase cluster. A single word is fine. Omitting query entirely when tokens provides sufficient scoping is preferred.
|
|
16
23
|
- keyword is kept for backward compatibility and can be used the same way as query.
|
|
17
24
|
- The backend handles query and keyword on the same search path, so do NOT split intent across them. If both are present, keep them aligned.
|
|
18
|
-
- Good style:
|
|
25
|
+
- Good style: "hyperliquid validator hack", "solana meme coin launch", "btc etf inflow", or just tokens=MONAD with no query for a general project feed.
|
|
19
26
|
- Remove filler words, generic words like "crypto" or "news", and temporal phrases from query/keyword. Pass time with min_created_at / max_created_at instead.
|
|
20
27
|
|
|
21
28
|
SEARCH BEHAVIOR — AND LOGIC:
|
|
@@ -25,10 +32,9 @@ SEARCH BEHAVIOR — AND LOGIC:
|
|
|
25
32
|
- It is OK to include multiple entities when they belong to the same frame, such as "Hyperliquid vs Lighter", "ETH vs SOL fees", or "BTC gold correlation".
|
|
26
33
|
- Split into multiple searches only when the user is combining unrelated topics, time windows, or objectives in one request.
|
|
27
34
|
- If a project name is ambiguous or a ticker exists, use tokens for disambiguation.
|
|
28
|
-
- Do NOT rely on tokens alone for major tickers (BTC, ETH, SOL) when the user wants a specific topic. Pair tokens with query/keyword.
|
|
29
35
|
|
|
30
36
|
QUERY CONSTRUCTION:
|
|
31
|
-
- Start with the smallest high-signal query/keyword that captures the user intent.
|
|
37
|
+
- Start with the smallest high-signal query/keyword that captures the user intent. Often tokens alone with no query is the right call.
|
|
32
38
|
- Do NOT manually add long OR chains, synonym lists, plural variants, ticker variants, or handle variants by default. The backend already broadens recall through a secondary retrieval path.
|
|
33
39
|
- Use quotes or explicit AND/OR/NOT only when the user explicitly wants exact phrase matching or literal boolean logic.
|
|
34
40
|
- If results are sparse, relax the weakest qualifier or widen the time range instead of adding more terms.
|
|
@@ -52,7 +58,7 @@ OUTPUT NOTES:
|
|
|
52
58
|
query: z
|
|
53
59
|
.string()
|
|
54
60
|
.optional()
|
|
55
|
-
.describe("Primary
|
|
61
|
+
.describe("Primary text query. Can be 1-6 high-signal words (e.g. 'validator hack', 'etf inflow'). Omit entirely when tokens alone is sufficient. Avoid filler words and time expressions."),
|
|
56
62
|
usernames: z
|
|
57
63
|
.string()
|
|
58
64
|
.optional()
|
|
@@ -76,7 +82,7 @@ OUTPUT NOTES:
|
|
|
76
82
|
size: z
|
|
77
83
|
.number()
|
|
78
84
|
.optional()
|
|
79
|
-
.describe("Results per page 50
|
|
85
|
+
.describe("Results per page 20-50 (default: 50)"),
|
|
80
86
|
languages: z
|
|
81
87
|
.string()
|
|
82
88
|
.optional()
|
|
@@ -171,7 +177,7 @@ OUTPUT NOTES:
|
|
|
171
177
|
baseParams[key] = value.toString();
|
|
172
178
|
}
|
|
173
179
|
}
|
|
174
|
-
baseParams.size = Math.max(size ??
|
|
180
|
+
baseParams.size = Math.max(size ?? 50, 50).toString();
|
|
175
181
|
baseParams.raw_text = "true";
|
|
176
182
|
if (query !== undefined)
|
|
177
183
|
baseParams.query = query;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"advanced-search.js","sourceRoot":"","sources":["../../src/tools/advanced-search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,UAAU,0BAA0B,CAAC,MAAiB,EAAE,MAAmB;IAC/E,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EAAE,GAAG,oBAAoB
|
|
1
|
+
{"version":3,"file":"advanced-search.js","sourceRoot":"","sources":["../../src/tools/advanced-search.ts"],"names":[],"mappings":"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"}
|