okdata 0.1.0__tar.gz → 0.1.1__tar.gz
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.
- {okdata-0.1.0 → okdata-0.1.1}/PKG-INFO +57 -5
- {okdata-0.1.0 → okdata-0.1.1}/README.md +52 -2
- {okdata-0.1.0 → okdata-0.1.1}/pyproject.toml +5 -1
- okdata-0.1.1/src/okdata/_version.py +1 -0
- okdata-0.1.0/src/okdata/_version.py +0 -1
- {okdata-0.1.0 → okdata-0.1.1}/.gitignore +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/LICENSE +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/__init__.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_async_client.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_base.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_client.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_errors.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/__init__.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_async.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_endpoints.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_errors.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_models.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_sync.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_money.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_paging.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_request.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_result.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_transport.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_types.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/src/okdata/py.typed +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/tests/__init__.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/tests/conftest.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/tests/mock_api.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/tests/test_client.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/tests/test_contract.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/tests/test_generated.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/tests/test_live.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/tests/test_paging.py +0 -0
- {okdata-0.1.0 → okdata-0.1.1}/tests/typing_check.py +0 -0
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: okdata
|
|
3
|
-
Version: 0.1.
|
|
4
|
-
Summary: Python SDK for okdata
|
|
3
|
+
Version: 0.1.1
|
|
4
|
+
Summary: Python SDK for okdata, the social data API and MCP server for AI agents: TikTok, RedNote (Xiaohongshu), Douyin, WeChat, X, YouTube, Bilibili, Weibo and more, paid per call. Typed methods per endpoint, sync and async, safe retries, paging with a spend limit.
|
|
5
5
|
Project-URL: Homepage, https://okdata.online/
|
|
6
|
+
Project-URL: MCP server, https://okdata.online/mcp/
|
|
7
|
+
Project-URL: 中文, https://okdata.online/zh/
|
|
6
8
|
Project-URL: Documentation, https://okdata.online/docs/sdk/
|
|
7
9
|
Project-URL: Endpoints, https://okdata.online/apis/
|
|
8
10
|
Project-URL: Pricing, https://okdata.online/pricing/
|
|
@@ -11,7 +13,7 @@ Project-URL: Issues, https://github.com/okdataapi/okdata/issues
|
|
|
11
13
|
Author-email: okdata <hello@okdata.online>
|
|
12
14
|
License-Expression: MIT
|
|
13
15
|
License-File: LICENSE
|
|
14
|
-
Keywords: ai agents,bilibili,douyin,instagram,mcp,okdata,reddit,rednote,sdk,social data,social media api,tiktok,twitter,wechat,weibo,x,xiaohongshu,youtube
|
|
16
|
+
Keywords: ai agents,bilibili,claude,cursor,douyin,douyin api,instagram,kuaishou,mcp,mcp server,okdata,reddit,rednote,sdk,social data,social media api,social media data,tiktok,tiktok api,twitter,wechat,wechat official account,weibo,x,xiaohongshu,xiaohongshu api,xingtu,youtube
|
|
15
17
|
Classifier: Development Status :: 4 - Beta
|
|
16
18
|
Classifier: Intended Audience :: Developers
|
|
17
19
|
Classifier: Operating System :: OS Independent
|
|
@@ -35,8 +37,13 @@ Description-Content-Type: text/markdown
|
|
|
35
37
|
|
|
36
38
|
# okdata for Python
|
|
37
39
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
+
**抖音数据 API · 小红书数据接口 · 公众号文章阅读数接口 · 星图 / 蒲公英达人数据 · 社媒数据 MCP。**
|
|
41
|
+
[中文说明](#中文) · [中文文档](https://okdata.online/zh/docs/sdk/?src=pypi-okdata)
|
|
42
|
+
|
|
43
|
+
Social data for AI agents, paid per call: TikTok, RedNote (Xiaohongshu), Douyin, WeChat (Official Accounts
|
|
44
|
+
and Channels), X, YouTube, Instagram, Reddit, Bilibili, Weibo, Kuaishou and more. 200+ endpoints on 17
|
|
45
|
+
platforms behind one key, as typed Python methods, plain HTTP, or a remote MCP server for Claude, Cursor
|
|
46
|
+
and Codex. A call that fails costs nothing, and you need no platform accounts, cookies or QR logins.
|
|
40
47
|
Every endpoint is a typed method generated from the okdata catalog, with its price in its docstring.
|
|
41
48
|
|
|
42
49
|
```sh
|
|
@@ -47,6 +54,51 @@ export OKDATA_API_KEY=okd_...
|
|
|
47
54
|
No key yet? Sign up at [okdata.online](https://okdata.online/signup/?src=pypi-okdata)
|
|
48
55
|
(中文:[注册](https://okdata.online/zh/signup/?src=pypi-okdata)).
|
|
49
56
|
|
|
57
|
+
## What you can read
|
|
58
|
+
|
|
59
|
+
| Platform | For example | Per call or item |
|
|
60
|
+
|---|---|---|
|
|
61
|
+
| Douyin (抖音) | video search, comments and replies, plays and likes, the hot list, Xingtu (星图) creators with rates and audience | from $0.002 |
|
|
62
|
+
| Xiaohongshu / RedNote (小红书) | note search, notes, comments, creators, PGY (蒲公英) creators, shop products and reviews | from $0.02 |
|
|
63
|
+
| WeChat (微信) | Official Account (公众号) articles with reads and likes, Channels (视频号) videos and comments, WeChat Search | from $0.015 |
|
|
64
|
+
| Weibo (微博) | the hot search list, post search, comments, accounts | from $0.002 |
|
|
65
|
+
| Bilibili (B站) | video search, comments, uploader videos, the popular board | from $0.002 |
|
|
66
|
+
| Kuaishou (快手) | video search, comments, accounts, the hot list | from $0.002 |
|
|
67
|
+
| TikTok | video search, comments, accounts, transcripts, TikTok Shop products, Creative Center ads | from $0.002 |
|
|
68
|
+
| X (Twitter) | post search, replies, quotes, accounts, followers, lists, communities | from $0.0001 |
|
|
69
|
+
| YouTube, Instagram, Reddit, Telegram | search, posts, comments, channels and accounts, transcripts | from $0.002 |
|
|
70
|
+
| Meta and Google ad libraries | ads by keyword or advertiser | from $0.004 |
|
|
71
|
+
|
|
72
|
+
Every endpoint with its parameters, fields and price: [okdata.online/apis](https://okdata.online/apis/?src=pypi-okdata)
|
|
73
|
+
(中文:[接口列表](https://okdata.online/zh/apis/?src=pypi-okdata)).
|
|
74
|
+
|
|
75
|
+
## Use it from Claude, Cursor or Codex (MCP)
|
|
76
|
+
|
|
77
|
+
An agent can use the same endpoints without this SDK, through the remote MCP server at
|
|
78
|
+
`https://api.okdata.online/mcp` (Streamable HTTP, header `Authorization: Bearer <key>`). In Claude Code:
|
|
79
|
+
|
|
80
|
+
```sh
|
|
81
|
+
claude mcp add --transport http --scope user okdata https://api.okdata.online/mcp \
|
|
82
|
+
--header 'Authorization: Bearer ${OKDATA_API_KEY}'
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
`npx okdata setup --client cursor` (or `codex`, `claude-code`) writes the entry for you. The agent looks up
|
|
86
|
+
an endpoint and its price for free; only the data call is charged. More clients:
|
|
87
|
+
[okdata.online/mcp](https://okdata.online/mcp/?src=pypi-okdata).
|
|
88
|
+
|
|
89
|
+
<a id="中文"></a>
|
|
90
|
+
|
|
91
|
+
## 中文
|
|
92
|
+
|
|
93
|
+
okdata 是给 AI 智能体和代码用的社媒数据接口,按次付费。一个 key 就能读抖音、小红书、公众号、视频号、B站、微博、快手,
|
|
94
|
+
以及 TikTok、X、YouTube、Instagram、Reddit 的公开数据:搜视频和笔记、批量拉评论、查星图和蒲公英达人、
|
|
95
|
+
拿公众号文章的阅读数和点赞数、看微博热搜和抖音热榜。可以用这个 Python SDK,也可以在 Claude、Cursor、Codex 里
|
|
96
|
+
接 MCP(上面那一条命令),或者直接发 HTTP 请求。调用失败不扣钱,不需要平台账号、Cookie,也不用扫码。
|
|
97
|
+
支付宝、微信、银行卡都能充值。
|
|
98
|
+
|
|
99
|
+
[中文文档](https://okdata.online/zh/docs/sdk/?src=pypi-okdata) · [接口和价格](https://okdata.online/zh/apis/?src=pypi-okdata) ·
|
|
100
|
+
[MCP 接入](https://okdata.online/zh/mcp/?src=pypi-okdata) · [注册](https://okdata.online/zh/signup/?src=pypi-okdata)
|
|
101
|
+
|
|
50
102
|
## First call
|
|
51
103
|
|
|
52
104
|
The Playground's Python tab shows the raw HTTP request; with the SDK the same call is:
|
|
@@ -1,7 +1,12 @@
|
|
|
1
1
|
# okdata for Python
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
**抖音数据 API · 小红书数据接口 · 公众号文章阅读数接口 · 星图 / 蒲公英达人数据 · 社媒数据 MCP。**
|
|
4
|
+
[中文说明](#中文) · [中文文档](https://okdata.online/zh/docs/sdk/?src=pypi-okdata)
|
|
5
|
+
|
|
6
|
+
Social data for AI agents, paid per call: TikTok, RedNote (Xiaohongshu), Douyin, WeChat (Official Accounts
|
|
7
|
+
and Channels), X, YouTube, Instagram, Reddit, Bilibili, Weibo, Kuaishou and more. 200+ endpoints on 17
|
|
8
|
+
platforms behind one key, as typed Python methods, plain HTTP, or a remote MCP server for Claude, Cursor
|
|
9
|
+
and Codex. A call that fails costs nothing, and you need no platform accounts, cookies or QR logins.
|
|
5
10
|
Every endpoint is a typed method generated from the okdata catalog, with its price in its docstring.
|
|
6
11
|
|
|
7
12
|
```sh
|
|
@@ -12,6 +17,51 @@ export OKDATA_API_KEY=okd_...
|
|
|
12
17
|
No key yet? Sign up at [okdata.online](https://okdata.online/signup/?src=pypi-okdata)
|
|
13
18
|
(中文:[注册](https://okdata.online/zh/signup/?src=pypi-okdata)).
|
|
14
19
|
|
|
20
|
+
## What you can read
|
|
21
|
+
|
|
22
|
+
| Platform | For example | Per call or item |
|
|
23
|
+
|---|---|---|
|
|
24
|
+
| Douyin (抖音) | video search, comments and replies, plays and likes, the hot list, Xingtu (星图) creators with rates and audience | from $0.002 |
|
|
25
|
+
| Xiaohongshu / RedNote (小红书) | note search, notes, comments, creators, PGY (蒲公英) creators, shop products and reviews | from $0.02 |
|
|
26
|
+
| WeChat (微信) | Official Account (公众号) articles with reads and likes, Channels (视频号) videos and comments, WeChat Search | from $0.015 |
|
|
27
|
+
| Weibo (微博) | the hot search list, post search, comments, accounts | from $0.002 |
|
|
28
|
+
| Bilibili (B站) | video search, comments, uploader videos, the popular board | from $0.002 |
|
|
29
|
+
| Kuaishou (快手) | video search, comments, accounts, the hot list | from $0.002 |
|
|
30
|
+
| TikTok | video search, comments, accounts, transcripts, TikTok Shop products, Creative Center ads | from $0.002 |
|
|
31
|
+
| X (Twitter) | post search, replies, quotes, accounts, followers, lists, communities | from $0.0001 |
|
|
32
|
+
| YouTube, Instagram, Reddit, Telegram | search, posts, comments, channels and accounts, transcripts | from $0.002 |
|
|
33
|
+
| Meta and Google ad libraries | ads by keyword or advertiser | from $0.004 |
|
|
34
|
+
|
|
35
|
+
Every endpoint with its parameters, fields and price: [okdata.online/apis](https://okdata.online/apis/?src=pypi-okdata)
|
|
36
|
+
(中文:[接口列表](https://okdata.online/zh/apis/?src=pypi-okdata)).
|
|
37
|
+
|
|
38
|
+
## Use it from Claude, Cursor or Codex (MCP)
|
|
39
|
+
|
|
40
|
+
An agent can use the same endpoints without this SDK, through the remote MCP server at
|
|
41
|
+
`https://api.okdata.online/mcp` (Streamable HTTP, header `Authorization: Bearer <key>`). In Claude Code:
|
|
42
|
+
|
|
43
|
+
```sh
|
|
44
|
+
claude mcp add --transport http --scope user okdata https://api.okdata.online/mcp \
|
|
45
|
+
--header 'Authorization: Bearer ${OKDATA_API_KEY}'
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
`npx okdata setup --client cursor` (or `codex`, `claude-code`) writes the entry for you. The agent looks up
|
|
49
|
+
an endpoint and its price for free; only the data call is charged. More clients:
|
|
50
|
+
[okdata.online/mcp](https://okdata.online/mcp/?src=pypi-okdata).
|
|
51
|
+
|
|
52
|
+
<a id="中文"></a>
|
|
53
|
+
|
|
54
|
+
## 中文
|
|
55
|
+
|
|
56
|
+
okdata 是给 AI 智能体和代码用的社媒数据接口,按次付费。一个 key 就能读抖音、小红书、公众号、视频号、B站、微博、快手,
|
|
57
|
+
以及 TikTok、X、YouTube、Instagram、Reddit 的公开数据:搜视频和笔记、批量拉评论、查星图和蒲公英达人、
|
|
58
|
+
拿公众号文章的阅读数和点赞数、看微博热搜和抖音热榜。可以用这个 Python SDK,也可以在 Claude、Cursor、Codex 里
|
|
59
|
+
接 MCP(上面那一条命令),或者直接发 HTTP 请求。调用失败不扣钱,不需要平台账号、Cookie,也不用扫码。
|
|
60
|
+
支付宝、微信、银行卡都能充值。
|
|
61
|
+
|
|
62
|
+
[中文文档](https://okdata.online/zh/docs/sdk/?src=pypi-okdata) · [接口和价格](https://okdata.online/zh/apis/?src=pypi-okdata) ·
|
|
63
|
+
[MCP 接入](https://okdata.online/zh/mcp/?src=pypi-okdata) · [注册](https://okdata.online/zh/signup/?src=pypi-okdata)
|
|
64
|
+
|
|
15
65
|
## First call
|
|
16
66
|
|
|
17
67
|
The Playground's Python tab shows the raw HTTP request; with the SDK the same call is:
|
|
@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "okdata"
|
|
7
7
|
dynamic = ["version"]
|
|
8
|
-
description = "Python SDK for okdata
|
|
8
|
+
description = "Python SDK for okdata, the social data API and MCP server for AI agents: TikTok, RedNote (Xiaohongshu), Douyin, WeChat, X, YouTube, Bilibili, Weibo and more, paid per call. Typed methods per endpoint, sync and async, safe retries, paging with a spend limit."
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
license = "MIT"
|
|
11
11
|
license-files = ["LICENSE"]
|
|
@@ -15,6 +15,8 @@ dependencies = ["httpx>=0.25,<1"]
|
|
|
15
15
|
keywords = [
|
|
16
16
|
"okdata", "sdk", "social media api", "social data", "ai agents", "mcp", "douyin", "xiaohongshu", "rednote",
|
|
17
17
|
"wechat", "bilibili", "weibo", "tiktok", "twitter", "x", "youtube", "instagram", "reddit",
|
|
18
|
+
"kuaishou", "douyin api", "xiaohongshu api", "tiktok api", "xingtu", "wechat official account",
|
|
19
|
+
"mcp server", "claude", "cursor", "social media data",
|
|
18
20
|
]
|
|
19
21
|
classifiers = [
|
|
20
22
|
"Development Status :: 4 - Beta",
|
|
@@ -33,6 +35,8 @@ classifiers = [
|
|
|
33
35
|
|
|
34
36
|
[project.urls]
|
|
35
37
|
Homepage = "https://okdata.online/"
|
|
38
|
+
"MCP server" = "https://okdata.online/mcp/"
|
|
39
|
+
"中文" = "https://okdata.online/zh/"
|
|
36
40
|
Documentation = "https://okdata.online/docs/sdk/"
|
|
37
41
|
Endpoints = "https://okdata.online/apis/"
|
|
38
42
|
Pricing = "https://okdata.online/pricing/"
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
__version__ = "0.1.1"
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
__version__ = "0.1.0"
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|