meetlark

为人类及其代理人安排民意调查。创建投票、分享参与链接、收集选票并找到最佳会议时间。专为人工智能代理时代打造的涂鸦替代品。

# meetlark.ai — Scheduling polls for humans and their agents

A Doodle alternative built for the age of AI agents. Create a poll, share a link, collect votes, find the best time.

## Two Tokens

When you create a poll you get two tokens:

- **Admin token** (`adm_...`) — Private. View full results, see who voted, close the poll. Store it in your memory for the poll's lifetime.
- **Participate token** (`prt_...`) — Shareable. Anyone with the participate URL can vote — humans via the web UI, agents via the API. Multiple people use the same link.

## Creating a Poll

Ask the user what times work and create the poll with those time slots.

```
POST https://meetlark.ai/api/v1/polls?autoVerify=true
```

The response includes `adminToken` and `participateUrl`.

### Email Verification

Poll creation requires a verified email (one-time, valid for 30 days of activity).

Use `?autoVerify=true` — if the email is unverified, the API automatically sends a verification email and returns:
```json
{
  "error": {
    "code": "email_not_verified",
    "details": { "verificationSent": true, "email": "user@example.com" }
  }
}
```

Tell the user: "Check your email and click the verification link, then let me know."

Poll `GET /api/v1/auth/status?email=...` until `verified: true`, then retry.

## Sharing the Poll

Give the participate URL to the user and ask them to share it. Suggest a message:

```
Hi [name/team],

[Creator] has created a poll to find the best time for [meeting purpose].

Vote here: [participate URL]

Please vote on the times that work for you.
```

## Checking Results

```
GET https://meetlark.ai/api/v1/polls/{pollId}
Authorization: Bearer adm_...
```

Returns vote counts per time slot and individual votes.

## Closing the Poll

```
POST https://meetlark.ai/api/v1/polls/{pollId}/close
Authorization: Bearer adm_...
```

## Quick Examples

```
"Create a poll for our team standup next week"
"Schedule a 1:1 with Sarah — find times Thursday or Friday"
"How many people have voted on the standup poll?"
"Close the poll and tell me the winning time"
```

## API

- **OpenAPI spec:** https://meetlark.ai/api/v1/openapi.json
- **Interactive docs:** https://meetlark.ai/docs
- **AI plugin manifest:** https://meetlark.ai/.well-known/ai-plugin.json

## Website

- **meetlark.ai:** https://meetlark.ai

---

## 中文说明

# meetlark.ai — 为人类及其代理安排时间的投票

一款为 AI 代理时代打造的 Doodle 替代品。创建投票、分享链接、收集选票、找到最佳时间。

## 两种令牌

创建投票时你会获得两种令牌：

- **管理令牌（Admin token）**（`adm_...`）— 私密。查看完整结果、查看谁投了票、关闭投票。在投票的整个生命周期内将其存储在你的记忆中。
- **参与令牌（Participate token）**（`prt_...`）— 可分享。任何拥有参与 URL 的人都可以投票——人类通过 Web 界面，代理通过 API。多人可使用同一链接。

## 创建投票

询问用户哪些时间合适，并用这些时间段创建投票。

```
POST https://meetlark.ai/api/v1/polls?autoVerify=true
```

响应中包含 `adminToken` 和 `participateUrl`。

### 邮箱验证

创建投票需要已验证的邮箱（一次性验证，活跃状态下有效期 30 天）。

使用 `?autoVerify=true`——如果邮箱未验证，API 会自动发送验证邮件并返回：
```json
{
  "error": {
    "code": "email_not_verified",
    "details": { "verificationSent": true, "email": "user@example.com" }
  }
}
```

告诉用户："请查收邮件并点击验证链接，然后告诉我。"

轮询 `GET /api/v1/auth/status?email=...` 直到 `verified: true`，然后重试。

## 分享投票

将参与 URL 提供给用户并请他们分享。建议一条消息：

```
Hi [name/team],

[Creator] has created a poll to find the best time for [meeting purpose].

Vote here: [participate URL]

Please vote on the times that work for you.
```

## 查看结果

```
GET https://meetlark.ai/api/v1/polls/{pollId}
Authorization: Bearer adm_...
```

返回每个时间段的票数和单个投票。

## 关闭投票

```
POST https://meetlark.ai/api/v1/polls/{pollId}/close
Authorization: Bearer adm_...
```

## 快速示例

```
"Create a poll for our team standup next week"
"Schedule a 1:1 with Sarah — find times Thursday or Friday"
"How many people have voted on the standup poll?"
"Close the poll and tell me the winning time"
```

## API

- **OpenAPI 规范：** https://meetlark.ai/api/v1/openapi.json
- **交互式文档：** https://meetlark.ai/docs
- **AI 插件清单：** https://meetlark.ai/.well-known/ai-plugin.json

## 网站

- **meetlark.ai：** https://meetlark.ai