webcite-mcp-server 1.1.3 → 1.1.4
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/dist/api-client.d.ts +5 -20
- package/dist/api-client.d.ts.map +1 -1
- package/dist/api-client.js +14 -40
- package/dist/api-client.js.map +1 -1
- package/package.json +1 -1
package/dist/api-client.d.ts
CHANGED
|
@@ -1,18 +1,17 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* WebCite API Client
|
|
3
|
-
* Handles all communication with the WebCite backend API
|
|
2
|
+
* WebCite API Client - Public API endpoints
|
|
4
3
|
*/
|
|
5
4
|
export interface VerifyClaimOptions {
|
|
6
5
|
claim: string;
|
|
6
|
+
thread_id?: string;
|
|
7
7
|
include_stance?: boolean;
|
|
8
8
|
include_verdict?: boolean;
|
|
9
|
+
decompose_claim?: boolean;
|
|
9
10
|
use_claim_decomposition?: boolean;
|
|
10
|
-
thread_id?: string;
|
|
11
11
|
}
|
|
12
12
|
export interface SearchSourcesOptions {
|
|
13
13
|
query: string;
|
|
14
14
|
limit?: number;
|
|
15
|
-
thread_id?: string;
|
|
16
15
|
}
|
|
17
16
|
export interface ListCitationsOptions {
|
|
18
17
|
page?: number;
|
|
@@ -105,27 +104,13 @@ export interface ListCitationsResponse {
|
|
|
105
104
|
};
|
|
106
105
|
}
|
|
107
106
|
export declare class WebCiteApiClient {
|
|
108
|
-
private
|
|
109
|
-
private
|
|
107
|
+
private baseUrl;
|
|
108
|
+
private apiKey;
|
|
110
109
|
constructor(apiKey: string, baseUrl?: string);
|
|
111
110
|
private request;
|
|
112
|
-
/**
|
|
113
|
-
* Verify a factual claim against authoritative sources
|
|
114
|
-
* Full verification includes: search, stance analysis, and verdict
|
|
115
|
-
*/
|
|
116
111
|
verifyClaim(options: VerifyClaimOptions): Promise<VerifyClaimResponse>;
|
|
117
|
-
/**
|
|
118
|
-
* Search for sources related to a claim (citation only, no analysis)
|
|
119
|
-
* Cheaper option - just returns raw citations without stance/verdict
|
|
120
|
-
*/
|
|
121
112
|
searchSources(options: SearchSourcesOptions): Promise<VerifyClaimResponse>;
|
|
122
|
-
/**
|
|
123
|
-
* List all citations for the authenticated user
|
|
124
|
-
*/
|
|
125
113
|
listCitations(options?: ListCitationsOptions): Promise<ListCitationsResponse>;
|
|
126
|
-
/**
|
|
127
|
-
* Get a specific citation by ID
|
|
128
|
-
*/
|
|
129
114
|
getCitation(citationId: string): Promise<{
|
|
130
115
|
data: {
|
|
131
116
|
prompt: string;
|
package/dist/api-client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}
|
package/dist/api-client.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
/**
|
|
3
|
-
* WebCite API Client
|
|
4
|
-
* Handles all communication with the WebCite backend API
|
|
3
|
+
* WebCite API Client - Public API endpoints
|
|
5
4
|
*/
|
|
6
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
7
6
|
exports.WebCiteApiClient = void 0;
|
|
@@ -10,7 +9,7 @@ class WebCiteApiClient {
|
|
|
10
9
|
apiKey;
|
|
11
10
|
constructor(apiKey, baseUrl = 'https://api.webcite.co') {
|
|
12
11
|
this.apiKey = apiKey;
|
|
13
|
-
this.baseUrl = baseUrl.replace(/\/$/, '');
|
|
12
|
+
this.baseUrl = baseUrl.replace(/\/$/, '');
|
|
14
13
|
}
|
|
15
14
|
async request(endpoint, options = {}) {
|
|
16
15
|
const url = `${this.baseUrl}${endpoint}`;
|
|
@@ -18,7 +17,7 @@ class WebCiteApiClient {
|
|
|
18
17
|
...options,
|
|
19
18
|
headers: {
|
|
20
19
|
'Content-Type': 'application/json',
|
|
21
|
-
'
|
|
20
|
+
'x-api-key': this.apiKey,
|
|
22
21
|
...options.headers,
|
|
23
22
|
},
|
|
24
23
|
});
|
|
@@ -28,44 +27,27 @@ class WebCiteApiClient {
|
|
|
28
27
|
}
|
|
29
28
|
return response.json();
|
|
30
29
|
}
|
|
31
|
-
/**
|
|
32
|
-
* Verify a factual claim against authoritative sources
|
|
33
|
-
* Full verification includes: search, stance analysis, and verdict
|
|
34
|
-
*/
|
|
35
30
|
async verifyClaim(options) {
|
|
36
|
-
return this.request('/
|
|
31
|
+
return this.request('/api/v1/verify', {
|
|
37
32
|
method: 'POST',
|
|
38
33
|
body: JSON.stringify({
|
|
39
|
-
|
|
34
|
+
claim: options.claim,
|
|
40
35
|
thread_id: options.thread_id,
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
useVerdict: options.include_verdict !== false,
|
|
45
|
-
useClaimDecomposition: options.use_claim_decomposition ?? false,
|
|
36
|
+
include_stance: options.include_stance !== false,
|
|
37
|
+
include_verdict: options.include_verdict !== false,
|
|
38
|
+
decompose_claim: options.decompose_claim ?? options.use_claim_decomposition ?? false,
|
|
46
39
|
}),
|
|
47
40
|
});
|
|
48
41
|
}
|
|
49
|
-
/**
|
|
50
|
-
* Search for sources related to a claim (citation only, no analysis)
|
|
51
|
-
* Cheaper option - just returns raw citations without stance/verdict
|
|
52
|
-
*/
|
|
53
42
|
async searchSources(options) {
|
|
54
|
-
return this.request('/
|
|
43
|
+
return this.request('/api/v1/sources/search', {
|
|
55
44
|
method: 'POST',
|
|
56
45
|
body: JSON.stringify({
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
useCitationAnalyse: false, // Disable all analysis for raw search
|
|
60
|
-
useEnhancedAnalysis: false,
|
|
61
|
-
useStanceAnalysis: false,
|
|
62
|
-
useVerdict: false,
|
|
46
|
+
query: options.query,
|
|
47
|
+
limit: options.limit ?? 10,
|
|
63
48
|
}),
|
|
64
49
|
});
|
|
65
50
|
}
|
|
66
|
-
/**
|
|
67
|
-
* List all citations for the authenticated user
|
|
68
|
-
*/
|
|
69
51
|
async listCitations(options = {}) {
|
|
70
52
|
const params = new URLSearchParams();
|
|
71
53
|
if (options.page)
|
|
@@ -74,19 +56,11 @@ class WebCiteApiClient {
|
|
|
74
56
|
params.append('limit', String(options.limit));
|
|
75
57
|
if (options.thread_id)
|
|
76
58
|
params.append('thread_id', options.thread_id);
|
|
77
|
-
const
|
|
78
|
-
|
|
79
|
-
return this.request(endpoint, {
|
|
80
|
-
method: 'GET',
|
|
81
|
-
});
|
|
59
|
+
const qs = params.toString();
|
|
60
|
+
return this.request(`/api/v1/citations${qs ? `?${qs}` : ''}`, { method: 'GET' });
|
|
82
61
|
}
|
|
83
|
-
/**
|
|
84
|
-
* Get a specific citation by ID
|
|
85
|
-
*/
|
|
86
62
|
async getCitation(citationId) {
|
|
87
|
-
return this.request(`/
|
|
88
|
-
method: 'GET',
|
|
89
|
-
});
|
|
63
|
+
return this.request(`/api/v1/citations/${encodeURIComponent(citationId)}`, { method: 'GET' });
|
|
90
64
|
}
|
|
91
65
|
}
|
|
92
66
|
exports.WebCiteApiClient = WebCiteApiClient;
|
package/dist/api-client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":";AAAA;;;
|
|
1
|
+
{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}
|