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.
Files changed (34) hide show
  1. {okdata-0.1.0 → okdata-0.1.1}/PKG-INFO +57 -5
  2. {okdata-0.1.0 → okdata-0.1.1}/README.md +52 -2
  3. {okdata-0.1.0 → okdata-0.1.1}/pyproject.toml +5 -1
  4. okdata-0.1.1/src/okdata/_version.py +1 -0
  5. okdata-0.1.0/src/okdata/_version.py +0 -1
  6. {okdata-0.1.0 → okdata-0.1.1}/.gitignore +0 -0
  7. {okdata-0.1.0 → okdata-0.1.1}/LICENSE +0 -0
  8. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/__init__.py +0 -0
  9. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_async_client.py +0 -0
  10. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_base.py +0 -0
  11. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_client.py +0 -0
  12. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_errors.py +0 -0
  13. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/__init__.py +0 -0
  14. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_async.py +0 -0
  15. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_endpoints.py +0 -0
  16. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_errors.py +0 -0
  17. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_models.py +0 -0
  18. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_generated/_sync.py +0 -0
  19. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_money.py +0 -0
  20. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_paging.py +0 -0
  21. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_request.py +0 -0
  22. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_result.py +0 -0
  23. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_transport.py +0 -0
  24. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/_types.py +0 -0
  25. {okdata-0.1.0 → okdata-0.1.1}/src/okdata/py.typed +0 -0
  26. {okdata-0.1.0 → okdata-0.1.1}/tests/__init__.py +0 -0
  27. {okdata-0.1.0 → okdata-0.1.1}/tests/conftest.py +0 -0
  28. {okdata-0.1.0 → okdata-0.1.1}/tests/mock_api.py +0 -0
  29. {okdata-0.1.0 → okdata-0.1.1}/tests/test_client.py +0 -0
  30. {okdata-0.1.0 → okdata-0.1.1}/tests/test_contract.py +0 -0
  31. {okdata-0.1.0 → okdata-0.1.1}/tests/test_generated.py +0 -0
  32. {okdata-0.1.0 → okdata-0.1.1}/tests/test_live.py +0 -0
  33. {okdata-0.1.0 → okdata-0.1.1}/tests/test_paging.py +0 -0
  34. {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.0
4
- Summary: Python SDK for okdata: social data from Douyin, Xiaohongshu, WeChat, Bilibili, Weibo, TikTok, X, YouTube and more, for AI agents, paid per call. Typed methods per endpoint, sync and async, safe retries, paging with a spend limit.
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
- Social data for AI agents, paid per call: Douyin, Xiaohongshu, WeChat, Bilibili, Weibo, Kuaishou, Zhihu,
39
- TikTok, X, YouTube, Instagram, Reddit and more, as one API with one envelope and one error format.
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
- Social data for AI agents, paid per call: Douyin, Xiaohongshu, WeChat, Bilibili, Weibo, Kuaishou, Zhihu,
4
- TikTok, X, YouTube, Instagram, Reddit and more, as one API with one envelope and one error format.
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: social data from Douyin, Xiaohongshu, WeChat, Bilibili, Weibo, TikTok, X, YouTube and more, for AI agents, paid per call. Typed methods per endpoint, sync and async, safe retries, paging with a spend limit."
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