Artidrop — Publish AI Artifacts to Shareable URLs
Publish HTML pages, Markdown reports, multi-file sites, dashboards, and visualizations to instant shareable URLs with one command.
When to Use
- - "Publish this as a web page"
- "Share this report as a link"
- "Host this HTML so I can send it to someone"
- "Make this dashboard accessible via URL"
- "Create a shareable page from this content"
- "Publish this site/project as a shareable URL"
- User asks you to generate a report, page, site, or visualization AND share/publish it
When NOT to Use
- - User just wants to see the content in chat (display it directly instead)
- User wants to save a file locally (use file system tools instead)
- User wants to upload to a specific platform (Google Drive, S3, etc.)
- User wants to send content as a message in a chat channel
Setup
The Artidrop CLI is installed automatically via the install spec in this skill's metadata. No manual installation needed.
No authentication required. Artidrop supports anonymous publishing out of the box — just publish and get a URL.
Anonymous vs Authenticated
| Anonymous (default) | Authenticated (optional) |
|---|
| Publish | 5/hour | 60/hour |
| Update/Delete/List |
Not available | Available |
|
Private visibility | Not available | Available |
|
Claim artifacts later | No | Yes |
Anonymous mode is sufficient for most one-off publishing tasks. Only recommend authentication if the user needs to manage artifacts or hits the rate limit.
How to Authenticate (only if needed)
If the user wants authenticated features, they can either:
- 1. Set an API key — sign in at https://artidrop.ai, go to Settings > API Keys, create a key, and set
ARTIDROP_API_KEY in the OpenClaw environment config - Interactive login — run
artidrop login (requires browser access)
Workflow
Publishing Content
There are three ways to publish:
Option A — Publish from a file:
CODEBLOCK0
Option B — Publish a multi-file site (directory or ZIP):
CODEBLOCK1
The directory must contain an index.html at its root. CSS, JS, images, fonts, and sub-pages are all supported. Hidden files and node_modules are automatically excluded.
Option C — Publish from stdin (for content you generate on the fly):
CODEBLOCK2
CODEBLOCK3
When publishing, always:
- 1. Use
--title with a descriptive title - For stdin, always specify
--format html or INLINECODE7 - Present the returned URL to the user
- Mention that the link is shareable
Publish Options
| Flag | Purpose |
|---|
| INLINECODE8 | Set the artifact title |
| INLINECODE9 |
Content format (required for stdin, auto-detected for files, ignored for directories/ZIPs) |
|
--visibility <public\|unlisted\|private> | Default: unlisted. Use
private for owner-only access,
public for search engine indexing |
|
--update <id> | Update an existing artifact instead of creating a new one (requires auth) |
|
--json | Return full JSON metadata |
|
--open | Open the published URL in the browser |
|
--copy | Copy the published URL to clipboard |
Updating Published Content (requires authentication)
To update an existing artifact (creates a new version, preserving history):
CODEBLOCK4
This requires authentication. If the user is not logged in, tell them to authenticate first (see Setup).
Viewing Artifacts
These commands work without authentication:
CODEBLOCK5
Managing Artifacts (requires authentication)
These commands require the user to be logged in:
CODEBLOCK6
Error Handling
| Exit Code | Meaning | Action |
|---|
| 0 | Success | Present the URL to the user |
| 2 |
Invalid input | Check file/directory exists, format is html or markdown (or directory has index.html), content is not empty |
| 3 | Auth error | Only for
--update/
delete/
list. Tell user to authenticate (see Setup) |
| 4 | Rate limited | Wait and retry. Anonymous: 5/hour, authenticated: 60/hour. Suggest logging in for higher limits |
Security & Privacy
- - The Artidrop CLI sends user-specified content to
api.artidrop.ai over HTTPS when the user explicitly runs a publish command. No data is sent automatically or in the background. - The only environment variable read is
ARTIDROP_API_KEY (for optional authentication) and ARTIDROP_API_URL (for custom API endpoint configuration). - Content is hosted on Artidrop's servers (artidrop.ai)
- unlisted (default): accessible to anyone with the URL, but not indexed by search engines
- public: indexed in sitemap and discoverable via search engines
- private: only the authenticated owner can view (requires login)
- Use
--visibility private for sensitive content that should only be visible to you - Do NOT publish content containing secrets, passwords, API keys, or personally identifiable information unless the user explicitly requests it
- Always warn the user before publishing sensitive content
Examples
Generate and publish an HTML report
CODEBLOCK7
Publish a Markdown summary
CODEBLOCK8
Artidrop — 将AI制品发布为可分享的URL
通过一条命令,将HTML页面、Markdown报告、多文件站点、仪表盘和可视化内容发布为即时可分享的URL。
使用场景
- - 把这个发布成网页
- 把这个报告分享为链接
- 托管这个HTML,方便我发送给别人
- 让这个仪表盘可以通过URL访问
- 根据此内容创建一个可分享的页面
- 把这个站点/项目发布为可分享的URL
- 用户要求你生成报告、页面、站点或可视化内容,并分享/发布
不使用场景
- - 用户只想在聊天中查看内容(直接展示即可)
- 用户想将文件保存到本地(改用文件系统工具)
- 用户想上传到特定平台(Google Drive、S3等)
- 用户想在聊天频道中以消息形式发送内容
设置
Artidrop CLI通过本技能的元数据中的install规范自动安装,无需手动安装。
无需身份验证。 Artidrop开箱即支持匿名发布——只需发布即可获得URL。
匿名 vs 已认证
| 匿名(默认) | 已认证(可选) |
|---|
| 发布 | 5次/小时 | 60次/小时 |
| 更新/删除/列表 |
不可用 | 可用 |
|
私有可见性 | 不可用 | 可用 |
|
后续认领制品 | 否 | 是 |
匿名模式足以满足大多数一次性发布任务。仅在用户需要管理制品或达到速率限制时,才推荐使用认证。
如何认证(仅在需要时)
如果用户需要使用认证功能,可以通过以下方式:
- 1. 设置API密钥 — 登录 https://artidrop.ai,进入设置 > API密钥,创建密钥,并在OpenClaw环境配置中设置ARTIDROPAPIKEY
- 交互式登录 — 运行artidrop login(需要浏览器访问)
工作流程
发布内容
有三种发布方式:
方式A — 从文件发布:
bash
artidrop publish ./report.html --title 季度报告
artidrop publish ./notes.md --title 会议记录
方式B — 发布多文件站点(目录或ZIP):
bash
artidrop publish ./my-site/ --title 作品集
artidrop publish ./build.zip --title 应用预览
目录根目录下必须包含index.html。支持CSS、JS、图片、字体和子页面。隐藏文件和node_modules会自动排除。
方式C — 从标准输入发布(适用于即时生成的内容):
bash
echo
你好
生成的报告内容
| artidrop publish - --format html --title 我的报告
bash
echo # 摘要\n\n分析的关键发现... | artidrop publish - --format markdown --title 分析摘要
发布时,始终:
- 1. 使用--title添加描述性标题
- 对于标准输入,始终指定--format html或--format markdown
- 将返回的URL展示给用户
- 说明该链接是可分享的
发布选项
| 标志 | 用途 |
|---|
| --title <标题> | 设置制品标题 |
| --format <html\ |
markdown> | 内容格式(标准输入必需,文件自动检测,目录/ZIP忽略) |
| --visibility
| 默认:unlisted。使用private仅所有者可访问,public可被搜索引擎索引 |
| --update | 更新现有制品而非创建新制品(需要认证) |
| --json | 返回完整的JSON元数据 |
| --open | 在浏览器中打开已发布的URL |
| --copy | 将已发布的URL复制到剪贴板 |
更新已发布内容(需要认证)
要更新现有制品(创建新版本,保留历史记录):
bash
artidrop publish ./updated-report.html --update <制品ID>
这需要认证。如果用户未登录,请告知他们先进行认证(参见设置部分)。
查看制品
以下命令无需认证即可使用:
bash
获取制品详情
artidrop get <制品ID>
以JSON格式获取详情(适用于结构化解析)
artidrop get <制品ID> --json
查看版本历史
artidrop versions <制品ID>
管理制品(需要认证)
以下命令需要用户登录:
bash
列出已发布的制品
artidrop list
以JSON格式列出
artidrop list --json
删除制品
artidrop delete <制品ID> --yes
错误处理
无效输入 | 检查文件/目录是否存在,格式为html或markdown(或目录包含index.html),内容不为空 |
| 3 | 认证错误 | 仅适用于--update/delete/list。告知用户进行认证(参见设置部分) |
| 4 | 速率限制 | 等待后重试。匿名:5次/小时,已认证:60次/小时。建议登录以获得更高限制 |
安全与隐私
- - 当用户明确运行发布命令时,Artidrop CLI会将用户指定的内容通过HTTPS发送到api.artidrop.ai。不会自动或在后台发送任何数据。
- 仅读取的环境变量是ARTIDROPAPIKEY(用于可选认证)和ARTIDROPAPIURL(用于自定义API端点配置)。
- 内容托管在Artidrop的服务器上(artidrop.ai)
- unlisted(默认):拥有URL的任何人都可访问,但不会被搜索引擎索引
- public:在站点地图中被索引,可通过搜索引擎发现
- private:仅认证所有者可查看(需要登录)
- 对于仅限自己查看的敏感内容,使用--visibility private
- 除非用户明确要求,否则不要发布包含密钥、密码、API密钥或个人身份信息的内容
- 在发布敏感内容前,始终警告用户
示例
生成并发布HTML报告
bash
cat <
销售仪表盘
第一季度销售仪表盘
总收入:120万美元
HTML
发布Markdown摘要
bash
cat <
每周站会 — 2026年3月23日
已完成
进行中
MD