Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@

AgentKey is the master key for the agent ecosystem. When using Claude, Manus, or other agents, you often need external data: social media, e-commerce, on-chain data, various APIs. That means hunting down API keys, managing subscriptions, or hitting dead ends.

With AgentKey installed, your agent gains all these data capabilities automatically. No subscriptions, no extra registrations. Top up and go.
With AgentKey installed, your agent gains all these data capabilities automatically. No per-provider registrations, no juggling separate API bills. One subscription and go.

> ⭐ Star this repo to get notified whenever we add new platform support or release updates.

Expand Down Expand Up @@ -59,7 +59,7 @@ Now: one AgentKey handles everything. **AgentKey unifies all the external access
Before touching the terminal, you can get a feel for AgentKey directly in your browser — the website and console explain things more visually than this README can.

- 🌐 **[agentkey.app](https://agentkey.app)** — Product overview, supported platforms, live demos, pricing details
- 🎛️ **[console.agentkey.app](https://console.agentkey.app)** — Sign up, top up credits, manage your API key, track usage
- 🎛️ **[console.agentkey.app](https://console.agentkey.app)** — Sign up, manage your subscription, manage your API key, track usage

The one-line install below is what plugs AgentKey into your AI agent. If you only want to look around first, the two links above are the friendlier starting point.

Expand Down Expand Up @@ -126,9 +126,9 @@ Native web access in Claude and ChatGPT has limited platform coverage. It often
</details>

<details>
<summary><b>What if I run out of credits?</b></summary>
<summary><b>How does pricing work? What if I use up my plan's credits?</b></summary>

Just top up. No auto-renewal, no hidden charges.
AgentKey is subscription-based. Each plan includes a monthly credit allowance; usage beyond that is billed pay-as-you-go as overage. You can upgrade your plan or manage billing anytime at [console.agentkey.app](https://console.agentkey.app). See [agentkey.app](https://agentkey.app) for current plans and pricing.

</details>

Expand Down
8 changes: 4 additions & 4 deletions docs/README_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@

AgentKey 是 Agent 生态里的"万能钥匙"。用户在用 Claude、Manus 这些 Agent 时,经常需要获取外部数据(社交媒体、电商、链上数据、各种 API),但要么要自己找 API 填 Key,要么根本找不到解决方案。

装了 AgentKey,Agent 就自动具备了这些数据获取能力。无需订阅,无需注册任何服务,充值即用
装了 AgentKey,Agent 就自动具备了这些数据获取能力。无需逐个注册服务、逐个管理账单,一份订阅全部搞定

> ⭐ 右上角 Star 本项目,我们会持续更新平台接入变化,有新版本自动通知你。

Expand Down Expand Up @@ -59,7 +59,7 @@ Agent 就像半智能体,完全无法自主行动,不断需要人类帮助
在动命令行之前,你可以先在浏览器里熟悉一下 AgentKey —— 官网和后台讲得比 README 更直观。

- 🌐 **[agentkey.app](https://agentkey.app)** —— 产品介绍、支持的平台、在线演示、计费说明
- 🎛️ **[console.agentkey.app](https://console.agentkey.app)** —— 注册账号、充值、管理 API Key、查看用量
- 🎛️ **[console.agentkey.app](https://console.agentkey.app)** —— 注册账号、管理订阅、管理 API Key、查看用量

下面的一条命令是把 AgentKey 接进你的 AI Agent。如果只是想先看看,上面两个链接是更友好的入口。

Expand Down Expand Up @@ -126,9 +126,9 @@ Claude 与 ChatGPT 的原生联网与平台覆盖有限,往往触达不到推
</details>

<details>
<summary><b>额度用完了怎么办?</b></summary>
<summary><b>怎么计费?套餐额度用完了怎么办?</b></summary>

充值即可;无自动续费,无隐藏扣款
AgentKey 采用订阅制。每档套餐包含每月的 credits 额度,超出部分按量计费(超额付费)。你可以随时在 [console.agentkey.app](https://console.agentkey.app) 升级套餐或管理账单。具体套餐与价格见 [agentkey.app](https://agentkey.app)

</details>

Expand Down
2 changes: 1 addition & 1 deletion skills/agentkey/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ Try first, guide if needed. Never ask about API keys before executing.
| Error | Action |
|-------|--------|
| `Authentication failed` | "API key invalid. Get a new one at https://console.agentkey.app/" |
| `Insufficient credits` | "Credits exhausted. Top up at https://console.agentkey.app/" |
| `Insufficient credits` | "Your plan's credits are exhausted. Upgrade your subscription or manage billing at https://console.agentkey.app/" |
| `Rate limited` | "Rate limited. Wait a moment and try again." |
| `not_found` | Report to user. Do NOT retry with guessed IDs. |
| Missing required param | Fix params using the `suggestion` field and retry once. |
Expand Down
6 changes: 3 additions & 3 deletions skills/agentkey/references/cost-aware.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Load this when the user's request implies **≥3 AgentKey calls** or **≥10 estimated credits**. The SKILL.md "Rules" section points here; you do not need to re-derive when it applies.

The goal: never burn the user's credit balance silently. Every batch run goes balance-check → cost-estimate → user-confirm → execute.
The goal: never burn the user's credit balance silently. AgentKey is subscription-based: each plan includes a credit allowance for the billing cycle, and usage beyond it is billed as pay-as-you-go overage — so silent overspend costs the user real money. Every batch run goes balance-check → cost-estimate → user-confirm → execute.

## 1. Pre-batch workflow

Expand Down Expand Up @@ -53,7 +53,7 @@ After estimating, present the plan in a single message before executing:

Wait for an explicit yes before calling `execute_tool`. If the user is operating an automated environment (no human in the loop indicated in conversation), proceed if the estimate is **≤ 25% of their remaining balance**; otherwise still pause and surface the numbers.

If the estimate **exceeds** the balance, do not start the batch. Tell the user how many calls fit (`floor(balance / credits_per_call)`) and ask whether to (a) run that subset, (b) stop, or (c) top up at https://console.agentkey.app first.
If the estimate **exceeds** the remaining allowance, do not start the batch — the excess would bill as overage. Tell the user how many calls fit within the allowance (`floor(balance / credits_per_call)`) and ask whether to (a) run that subset, (b) stop, (c) proceed anyway and accept the overage charge, or (d) upgrade their plan at https://console.agentkey.app first.

## 4. Cost-saving moves before you ask

Expand All @@ -78,6 +78,6 @@ Read the new balance via `agentkey_account` again only if the user asks — call

If `agentkey_account` errors or returns 0 with no clear reason, do not silently proceed. Tell the user:

> I couldn't verify your AgentKey balance before this batch. Top up or check status at https://console.agentkey.app, then re-ask.
> I couldn't verify your AgentKey balance before this batch. Check your subscription status at https://console.agentkey.app, then re-ask.

A failed balance read is almost always (a) the API key is missing/expired, or (b) a transient network blip. Both deserve user awareness before spending.
Loading