@jclvsh/xmark 0.2.0 → 0.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 +9 -9
- package/dist/client.js +2 -2
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# @jclvsh/xmark
|
|
2
2
|
|
|
3
|
-
MCP server and CLI for the [xmark](https://
|
|
3
|
+
MCP server and CLI for the [xmark](https://xmark.dev) API — chat with your X (Twitter) bookmarks from inside Claude Code, Cursor, or any MCP-compatible client.
|
|
4
4
|
|
|
5
5
|
## What is xmark?
|
|
6
6
|
|
|
7
|
-
xmark syncs your X bookmarks, embeds them with OpenAI, and lets you query them in natural language with citations back to the original tweets. This package wraps the [xmark REST API](https://api.xmark.
|
|
7
|
+
xmark syncs your X bookmarks, embeds them with OpenAI, and lets you query them in natural language with citations back to the original tweets. This package wraps the [xmark REST API](https://api.xmark.dev/openapi.json) as an MCP server (for AI clients) and a CLI (for terminal use).
|
|
8
8
|
|
|
9
9
|
## Install
|
|
10
10
|
|
|
@@ -18,16 +18,16 @@ npx -y -p @jclvsh/xmark xmark --help
|
|
|
18
18
|
|
|
19
19
|
## Setup
|
|
20
20
|
|
|
21
|
-
Set your xmark API key (get one at [/settings/api](https://
|
|
21
|
+
Set your xmark API key (get one at [/settings/api](https://xmark.dev/settings/api)):
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
24
|
export XMARK_API_KEY=xm_live_...
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
Optionally override the API host (default is `https://api.xmark.
|
|
27
|
+
Optionally override the API host (default is `https://api.xmark.dev`):
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
|
-
export XMARK_API_URL=https://api.xmark.
|
|
30
|
+
export XMARK_API_URL=https://api.xmark.dev
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
## Tools exposed via MCP
|
|
@@ -57,10 +57,10 @@ xmark is $5/month flat. The same subscription covers the web app, CLI, MCP serve
|
|
|
57
57
|
|
|
58
58
|
## Links
|
|
59
59
|
|
|
60
|
-
- Homepage: https://
|
|
61
|
-
- API reference: https://
|
|
62
|
-
- OpenAPI spec: https://api.xmark.
|
|
63
|
-
- llms.txt: https://api.xmark.
|
|
60
|
+
- Homepage: https://xmark.dev
|
|
61
|
+
- API reference: https://xmark.dev/docs
|
|
62
|
+
- OpenAPI spec: https://api.xmark.dev/openapi.json
|
|
63
|
+
- llms.txt: https://api.xmark.dev/llms.txt
|
|
64
64
|
|
|
65
65
|
## License
|
|
66
66
|
|
package/dist/client.js
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
const REQUEST_TIMEOUT_MS = 30_000;
|
|
2
|
-
const DEFAULT_BASE_URL = "https://api.xmark.
|
|
2
|
+
const DEFAULT_BASE_URL = "https://api.xmark.dev";
|
|
3
3
|
export class XmarkClient {
|
|
4
4
|
apiKey;
|
|
5
5
|
baseUrl;
|
|
6
6
|
constructor(apiKey, baseUrl) {
|
|
7
7
|
const key = apiKey ?? process.env.XMARK_API_KEY;
|
|
8
8
|
if (!key) {
|
|
9
|
-
throw new Error("XMARK_API_KEY environment variable is required. Get one at https://
|
|
9
|
+
throw new Error("XMARK_API_KEY environment variable is required. Get one at https://xmark.dev/settings/api");
|
|
10
10
|
}
|
|
11
11
|
this.apiKey = key;
|
|
12
12
|
this.baseUrl = (baseUrl ?? process.env.XMARK_API_URL ?? DEFAULT_BASE_URL).replace(/\/$/, "");
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jclvsh/xmark",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "MCP server and CLI for the xmark API — chat with your X bookmarks from inside Claude Code, Cursor, or any MCP client.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -46,5 +46,5 @@
|
|
|
46
46
|
"type": "git",
|
|
47
47
|
"url": "git+https://github.com/jclvsh/xmark.git"
|
|
48
48
|
},
|
|
49
|
-
"homepage": "https://
|
|
49
|
+
"homepage": "https://xmark.dev"
|
|
50
50
|
}
|