# Use okdata in Feishu: an aily agent or a Base automation

> Give a Feishu aily agent okdata as a custom MCP service, or call the API from a Base automation, so your team can ask about Douyin and Xiaohongshu in Feishu.

Canonical page: https://okdata.online/integrations/feishu/

The aim: someone on your team asks the company agent in Feishu "what are people on Xiaohongshu saying about our new flavour?" and gets an answer built from live notes, with links. aily, Feishu's agent builder for companies, takes okdata as a custom MCP service. Teams without aily can still pull data on a schedule into a Base (多维表格) with an HTTP request step.

## Connect it

Address: `https://api.okdata.online/mcp`

1. In a custom agent (自定义智能体), open the configuration panel on the right → 添加 MCP 服务 → 添加自定义 MCP. To share it across the company, create an enterprise custom MCP (企业自定义 MCP) in the MCP market instead.
2. Fill in the fields:

| Field | Value |
|---|---|
| 请求地址 Request URL | `https://api.okdata.online/mcp` |
| Endpoint 类型 | Streamable HTTP |
| 请求头 Header | `Authorization` = `Bearer okd_…`. Set it to 用户输入 (each user types their own key) or 固定值 (one shared key, entered by you). |


## Check it works

> List the okdata tools.

okdata is connected with 5 tools: `find` describe the data you need in words; get up to five capabilities with what they need, the price and a ready call. It never offers another platform in place of the one asked for; `describe` read the full contract of one to five capabilities: parameters, links taken, price and the most a call can cost, paging, fields and an example item; `call` fetch one page of data as text: the first lines say what it cost, the balance left and how to get the next page. Failed calls are free; max_price caps a call; `read_more` read the rest of an answer that was cut at about 20 KB, or the same result in another view, for 24 hours; `account` balance and the key’s spending limits, a receipt for one call, usage by day or capability; which capabilities are up, even without a key. Only `call` costs money. The catalog has 214 endpoints on 17 platforms.

## A first conversation

> What is on Weibo hot search right now?

| Tool call | Result | Cost |
|---|---|---|
| `find {"query":"weibo hot search"}` | weibo.trends.list · $0.002 per call · about 50 board entries per page | Free |
| `call {"capability":"weibo.trends.list"}` | One page of about 50 entries | $0.002 |

2 tool calls · 1 charged · $0.002

## Tips for Feishu (Lark) aily

- **Let the free tools run without asking.** Allow `find`, `describe` and `account`; keep `call` on “ask” if you want to approve every charge.
- **Ask for the cost first.** “Tell me what this will cost before you call anything” works in every client.
- **Give each client its own key.** Create one per app in the console; revoking it then touches nothing else.
- **Retries are safe.** A resent call with the same `idempotency_key` is never charged twice, and failed calls are free.

## What to know about Feishu (Lark) aily

- aily is a Feishu product for companies; your company has to have it switched on.
- A shared key (固定值) bills every user's calls to one balance. Give that key its own small balance, or let each user bring their own (用户输入).
- Feishu suggests keeping no more than five MCP services on in one conversation.
- Without aily: a Base (多维表格) automation can call the HTTP API on a schedule with its 发送 HTTP 请求 action: the endpoint address, query parameters and an Authorization header, answer written back to a field. You pick the endpoint yourself; it times out after 60 seconds.

Then try: “Use okdata to find popular Xiaohongshu notes about sunscreen.”

From Feishu (Lark) aily's own documentation, read on 2026-11-12. Menus move; if a step differs, the client's page is right.

- https://aily.feishu.cn/hc/1u7kleqg_fiogabrc
- https://www.feishu.cn/hc/zh-CN/articles/410063847664

## If something is off

| What you see | Why | Fix |
|---|---|---|
| Feishu (Lark) aily does not list the okdata tools | It was started before the server was added, or the address differs from the one above. | Check the entry, then restart Feishu (Lark) aily or start a new chat. |
| `find` works, `call` says `unauthorized` | The key did not arrive. `find` and `describe` need none, so they still answer. | Check the header is `Authorization` with `Bearer ` and a key starting with `okd_`, then restart. |
| `call` says `insufficient_balance` | The balance does not cover the most this call can cost. Nothing was charged. | Ask it to run `account`, then top up in the console. |