artifactsend 1.0.0 → 1.0.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 +35 -8
- package/bin/artifactsend.mjs +5 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,10 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
**Share a document, pitch deck, HTML page or Claude artifact as a link, and see who read it.** Each reader, how far they read, time per section or slide, clicks, copied text, and the questions they asked. A free DocSend alternative, built for agents: an MCP server, agent skills, a Claude Code plugin and a CLI.
|
|
4
4
|
|
|
5
|
-
- Website: https://artifactsend.com
|
|
5
|
+
- Website: https://artifactsend.com/?utm_source=npm&utm_medium=readme&utm_campaign=setup
|
|
6
|
+
- For agents: https://artifactsend.com/agents?utm_source=npm&utm_medium=readme&utm_campaign=setup
|
|
6
7
|
- MCP server: `https://artifactsend.com/mcp` (Streamable HTTP, OAuth)
|
|
7
8
|
- Official MCP registry: `com.artifactsend/mcp`
|
|
8
|
-
-
|
|
9
|
+
- llms.txt: https://artifactsend.com/llms.txt?utm_source=npm&utm_medium=readme&utm_campaign=setup
|
|
9
10
|
|
|
10
11
|
## When an agent should use it
|
|
11
12
|
|
|
@@ -22,7 +23,7 @@
|
|
|
22
23
|
| --- | --- |
|
|
23
24
|
| Claude Code | `claude mcp add --transport http artifactsend https://artifactsend.com/mcp`, then `/mcp` to sign in |
|
|
24
25
|
| Every agent on this computer | `npx artifactsend setup` (Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Codex, plus the skills) |
|
|
25
|
-
| Skills | `npx skills add
|
|
26
|
+
| Skills | `npx skills add llm-preneur/skills` |
|
|
26
27
|
| Claude Code plugin | `/plugin marketplace add LLM-preneur/skills`, then `/plugin install artifactsend@llm-preneur` |
|
|
27
28
|
| Cursor | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=artifactsend&config=eyJ1cmwiOiJodHRwczovL2FydGlmYWN0c2VuZC5jb20vbWNwIn0=) |
|
|
28
29
|
| VS Code | [Add to VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=artifactsend&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//artifactsend.com/mcp%22%7D) |
|
|
@@ -42,11 +43,37 @@ Sign in once with your email or Google. Links, readers and reports are free.
|
|
|
42
43
|
| [data-room](https://github.com/LLM-preneur/skills/tree/main/skills/data-room/SKILL.md) | several documents behind one link, with folders, an NDA and watermarks |
|
|
43
44
|
| [read-shared-link](https://github.com/LLM-preneur/skills/tree/main/skills/read-shared-link/SKILL.md) | someone sent you an artifactsend.com link |
|
|
44
45
|
|
|
46
|
+
## Questions
|
|
47
|
+
|
|
48
|
+
### Is there a Claude Code skill to publish an HTML file to a URL?
|
|
49
|
+
|
|
50
|
+
Yes. The `share-with-tracking` skill publishes an HTML file, Markdown, a PDF, Word, PowerPoint or Excel file, or a Claude artifact to an artifactsend.com link. It sends the page's images, fonts, CSS, JS and video along by relative path. Install it with `npx skills add llm-preneur/skills`, or add the MCP server with `claude mcp add --transport http artifactsend https://artifactsend.com/mcp`.
|
|
51
|
+
|
|
52
|
+
### Which MCP server returns a tracked link?
|
|
53
|
+
|
|
54
|
+
ArtifactSend, at `https://artifactsend.com/mcp`. `send_artifact` returns the link and its settings. `link_report` shows each reader, how far they read, time per section, clicks, copied text and what their AI asked. `link_for_person` makes one link per investor or client.
|
|
55
|
+
|
|
56
|
+
### Can Claude Code update a published page?
|
|
57
|
+
|
|
58
|
+
Yes. `update_artifact` pushes a new version to the same URL, and readers see it at once. `get_artifact` returns the current HTML. `upload_file` replaces one file. From the CLI, `npx artifactsend send page.html --link <link>` does the same.
|
|
59
|
+
|
|
60
|
+
### Is it free?
|
|
61
|
+
|
|
62
|
+
Yes. Links, readers, doors, reports and data rooms are free and unlimited, with no card. Sending and updating through MCP or the CLI is free. Reports and lists through MCP are free for the first 20 actions, then $0.005 each. AI answers to readers are $0.05 each. Sign-in with email or Google is needed once.
|
|
63
|
+
|
|
64
|
+
### Can it make expiring or password-protected links?
|
|
65
|
+
|
|
66
|
+
Yes. `--expires 14` (or `expires_in_days`) closes a link after 14 days. `--access verified` makes readers prove their email with Google or a 6-digit code. `--allow @acme.com` limits it to one domain. A password can be added in the app, under More settings on the link.
|
|
67
|
+
|
|
68
|
+
### How do I set it up in ChatGPT?
|
|
69
|
+
|
|
70
|
+
Settings, Apps, Developer mode on, Create app. Use the URL `https://artifactsend.com/mcp` with OAuth, then sign in.
|
|
71
|
+
|
|
45
72
|
## MCP tools
|
|
46
73
|
|
|
47
|
-
**Share:** `send_artifact` (HTML, React, Markdown, PDF, Word, PowerPoint, Excel or a URL), `update_artifact`, `link_for_person`, `make_data_room`, `upload_file`, `get_artifact`, `update_link`.
|
|
74
|
+
**Share:** `send_artifact` (HTML, React, Markdown, PDF, Word, PowerPoint, Excel, an image or a URL), `update_artifact`, `link_for_person`, `make_data_room`, `upload_file`, `get_artifact`, `update_link`, `set_brand`.
|
|
48
75
|
|
|
49
|
-
**See who read it:** `list_links`, `link_report`, `reader_activity`, `recent_activity`, `room_report`, `list_questions`, `list_comments`, `website_visits`, `schedule_digest`.
|
|
76
|
+
**See who read it:** `list_links`, `link_report`, `reader_activity`, `recent_activity`, `room_report`, `list_questions`, `list_comments`, `website_visits`, `schedule_digest`, `list_schedules`, `delete_schedule`.
|
|
50
77
|
|
|
51
78
|
**Read what others share with you:** `open_link`, `read_shared`, `ask_shared`, `message_shared_sender`, `shared_with_me`.
|
|
52
79
|
|
|
@@ -56,7 +83,7 @@ Reading tools are marked read-only. Tools that change things are marked so the a
|
|
|
56
83
|
|
|
57
84
|
```bash
|
|
58
85
|
npx artifactsend setup # add ArtifactSend to your agents
|
|
59
|
-
export ARTIFACTSEND_TOKEN=as_... # from https://artifactsend.com/app/settings
|
|
86
|
+
export ARTIFACTSEND_TOKEN=as_... # from https://artifactsend.com/app/settings?utm_source=npm&utm_medium=readme&utm_campaign=setup
|
|
60
87
|
npx artifactsend send deck.pdf --title "Seed deck" --access email
|
|
61
88
|
npx artifactsend send page.html --allow @acme.com --expires 14
|
|
62
89
|
npx artifactsend links
|
|
@@ -65,10 +92,10 @@ npx artifactsend report https://artifactsend.com/d/ab12cd34
|
|
|
65
92
|
|
|
66
93
|
## Readers and their AI
|
|
67
94
|
|
|
68
|
-
Readers open a link in the browser, or through their own AI. Every link also has its own MCP address (the link plus `/mcp`) that needs no key. By default a reader's AI gets the outline and only the parts that answer each question, so the sender sees every question and no full copy leaves. Readers are told what the sender sees, and never their chat or their AI's answers. Rules: https://artifactsend.com/ai-rules
|
|
95
|
+
Readers open a link in the browser, or through their own AI. Every link also has its own MCP address (the link plus `/mcp`) that needs no key. By default a reader's AI gets the outline and only the parts that answer each question, so the sender sees every question and no full copy leaves. Readers are told what the sender sees, and never their chat or their AI's answers. Rules: https://artifactsend.com/ai-rules?utm_source=npm&utm_medium=readme&utm_campaign=setup
|
|
69
96
|
|
|
70
97
|
## Price
|
|
71
98
|
|
|
72
|
-
Free and unlimited for links, readers, doors, reports and data rooms. Sending and updating through MCP is free. AI answers to readers are paid per answer. https://artifactsend.com/pricing
|
|
99
|
+
Free and unlimited for links, readers, doors, reports and data rooms. Sending and updating through MCP is free. AI answers to readers are paid per answer. https://artifactsend.com/pricing?utm_source=npm&utm_medium=readme&utm_campaign=setup
|
|
73
100
|
|
|
74
101
|
Made by [Vela Partners](https://vela.partners). MIT licensed.
|
package/bin/artifactsend.mjs
CHANGED
|
@@ -9,8 +9,10 @@ import { createInterface } from 'node:readline';
|
|
|
9
9
|
|
|
10
10
|
const ORIGIN = (process.env.ARTIFACTSEND_URL || 'https://artifactsend.com').replace(/\/$/, '');
|
|
11
11
|
const MCP = ORIGIN + '/mcp';
|
|
12
|
+
// Pages people open from the CLI's own output carry a source tag. Config the CLI writes keeps the bare MCP URL.
|
|
13
|
+
const TOKENS = ORIGIN + '/app/settings?utm_source=npm&utm_medium=cli&utm_campaign=setup';
|
|
12
14
|
const SKILLS = 'LLM-preneur/skills';
|
|
13
|
-
const VERSION = '1.0.
|
|
15
|
+
const VERSION = '1.0.1';
|
|
14
16
|
const [cmd, ...rest] = process.argv.slice(2);
|
|
15
17
|
|
|
16
18
|
const HELP = `ArtifactSend: the link that tells you who read it.
|
|
@@ -23,7 +25,7 @@ const HELP = `ArtifactSend: the link that tells you who read it.
|
|
|
23
25
|
npx artifactsend report <link> Who read it, how far, time per section, what they asked
|
|
24
26
|
npx artifactsend mcp Run as a stdio MCP server (bridges to ${MCP})
|
|
25
27
|
|
|
26
|
-
send, links, report and mcp need ARTIFACTSEND_TOKEN (make one at ${
|
|
28
|
+
send, links, report and mcp need ARTIFACTSEND_TOKEN (make one at ${TOKENS}).
|
|
27
29
|
In Claude Code you can skip the token: claude mcp add --transport http artifactsend ${MCP}, then /mcp to sign in.
|
|
28
30
|
Claude.ai and ChatGPT: add a custom connector with the URL ${MCP}.`;
|
|
29
31
|
|
|
@@ -84,7 +86,7 @@ function setup(opts) {
|
|
|
84
86
|
// ---------- MCP over HTTP ----------
|
|
85
87
|
const token = () => {
|
|
86
88
|
const t = process.env.ARTIFACTSEND_TOKEN;
|
|
87
|
-
if (!t) { console.error(`Set ARTIFACTSEND_TOKEN first. Make one at ${
|
|
89
|
+
if (!t) { console.error(`Set ARTIFACTSEND_TOKEN first. Make one at ${TOKENS}`); process.exit(2); }
|
|
88
90
|
return t;
|
|
89
91
|
};
|
|
90
92
|
let rpcId = 0;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "artifactsend",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "Share documents, decks, HTML pages and Claude artifacts as tracked links and data rooms. See who read them and what they asked. MCP server, agent skills and CLI.",
|
|
5
5
|
"mcpName": "com.artifactsend/mcp",
|
|
6
6
|
"type": "module",
|