@dimension-studios/ttk-proxy

中文文档
1.223.0发布于 2026/11/11ISCTypeScriptES Module近 30 天下载 5852

TikTok 代理 API 的 CLI 工具

中文使用文档
文档目录19 节
  1. 安装
  2. 配置
  3. 1. 使用环境变量(建议)
  4. 2. 使用国家综合指数
  5. 查看当前配置
  6. 清除配置
  7. 使用量
  8. 列出 TikTok 代理托肯斯
  9. 搜索店(按名称或子弹)
  10. 调用 TikTok 代理 API
  11. 产出
  12. API 参考
  13. 图标
  14. 发展
  15. 设置
  16. 本地测试
  17. 许可证
  18. 作者
  19. 支助

@ dimension- studios/ttk- 代理服务器

TikTok 代理 API 的 CLI 工具 - 一个简单的命令行接口,可以与 TikTok 代理服务交互.

安装

npm install -g @dimension-studios/ttk-proxy

配置

使用CLI 软件 conf 存储您的 API 证书。 您可以以两种方式配置:

设置以下环境变量:

export TTK_FETCH_API_URL="https://your-api-url.com"
export TTK_FETCH_API_KEY="your-api-key"
export TTK_FETCH_API_SECRET="your-api-secret"

然后运行配置命令以保存它们 :

ttk-proxy config

2. 使用国家综合指数

ttk-proxy config:set apiUrl "https://your-api-url.com"
ttk-proxy config:set apiKey "your-api-key"
ttk-proxy config:set apiSecret "your-api-secret"

查看当前配置

ttk-proxy config --show

清除配置

ttk-proxy config --clear

使用量

列出 TikTok 代理托肯斯

列出所有可用的 TikTok 代理符 :

ttk-proxy list

搜索店(按名称或子弹)

搜索商店 您的 API 令牌可以访问( 需要) GET /ttk-proxy/shops/search 在节点API上:

ttk-proxy shops coffee

调用 TikTok 代理 API

给TikTok代理API打电话

ttk-proxy call '{"shopId":"your-shop-id","url":"https://api.tiktok.com/endpoint","method":"GET"}'

较复杂身体的例子 :

ttk-proxy call '{
  "shopId": "shop-123",
  "url": "https://api.tiktok.com/v1/shops/products",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json"
  },
  "unofficialApi": {
    "addCookieToHeaders": true,
    "signUrl": true
  }
}'

基础64 支助

也可以通过JSON正体作为基础64-编码字符串. CLI会自动检测并解码:

# First encode your JSON to base64
echo -n '{"shopId":"shop-123","url":"https://api.tiktok.com/endpoint","method":"GET"}' | base64

# Then pass it directly to the CLI
ttk-proxy call "eyJzaG9wSWQiOiJzaG9wLTEyMyIsInVybCI6Imh0dHBzOi8vYXBpLnRpa3Rvay5jb20vZW5kcG9pbnQiLCJtZXRob2QiOiJHRVQifQ=="

这在从JSON已经基数64-编码的日志或其他来源复制请求体时有用.

产出

CLI 打印出要 stdout 的普通信件, 错误要 stderr .

示例输出 :

🚀 Calling TikTok Proxy API at https://your-api-url.com...
✅ Status: 200 OK

📦 Response:
{
  "code": 0,
  "data": {
    "products": [...]
  },
  "message": "success"
}

API 参考

图标

ttk-proxy call <body>

给TikTok代理API打电话,并配有JSON尸体.

  • 参数 :
    • body (字符串):用于请求的字符串JSON正体(可以是生JSON或基数64-编码JSON)

ttk-proxy list

列出所有 TikTok 代理符 .

ttk-proxy shops <query>

为您的 API 令牌授权的搜索店( )GET /ttk-proxy/shops/search 在你的节点API。 在 query。 。 。 .

ttk-proxy get-cookies <shopId>

为给定的店名获取 cookie JSON( 呼叫) POST /ttk-proxy/get-cookies) (中文(简体) ).

  • 选项 :
    • -i, --allow-invalid: 返回存储的饼干, 即使没有标记槽有效

ttk-proxy config

管理配置.

  • 选项 :
    • -s, --show: 显示当前配置
    • -c, --clear: 清除所有配置

ttk-proxy config:set <key> <value>

设定配置值 .

  • 参数 :
    • key (字符串):配置密钥(apiUrl, (中文(简体) ), apiKey,或 apiSecret(中文(简体) )
    • value (字符串):配置值

发展

设置

# Install dependencies (repo root)
bun install

# Build the package
bun run --cwd tools/ttk-proxy build

# Run type checking
bun run --cwd tools/ttk-proxy type-check

# Development mode (watch)
bun run --cwd tools/ttk-proxy dev

本地测试

# After building, run the CLI from the repo root
node tools/ttk-proxy/bin/cli.js --help

许可证

公务员制度委员会

作者

尺寸工作室

支助

关于议题和问题,请在 GitHub 存储器上打开一个问题.

版本与发布记录

@dimension-studios/ttk-proxy 共发布 699 个版本,首次发布于 2025/12/01;过去 12 个月发布了 699 个版本。

版本发布日期距今
1.223.0latest2026/11/111 天前
1.222.12026/11/101 天前
1.222.02026/11/102 天前
1.221.02026/11/102 天前
1.220.02026/11/092 天前
1.219.02026/11/074 天前

其他发布通道:beta → 1.31.0-preprod-release.340。

关于 @dimension-studios/ttk-proxy 的常见问题

@dimension-studios/ttk-proxy 是什么?

TikTok 代理 API 的 CLI 工具

如何安装 @dimension-studios/ttk-proxy?

在项目目录运行 npm install @dimension-studios/ttk-proxy,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ttk-proxy,可以用 npx ttk-proxy 直接运行。

@dimension-studios/ttk-proxy 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dimension-studios/ttk-proxy 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dimension-studios/ttk-proxy 可以商用吗?

@dimension-studios/ttk-proxy 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dimension-studios/ttk-proxy 的下载量有多少?

根据 npm 官方下载统计,@dimension-studios/ttk-proxy 在 2026/10/13 – 2026/11/11 这 30 天内被下载 5,852 次,日均约 195 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dimension-studios/ttk-proxy 还在维护吗?

最新版本 1.223.0 发布于 2026/11/11(1 天前);至今共发布 699 个版本,其中过去 12 个月发布了 699 个;首次发布于 2025/12/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。