@dimension-studios/shop-浏览器

交互式 CLI 和浏览器扩展来选择 TikTok 商店( 授权用于您的 API 令牌), 从维度加载 cookie TTK 获取 API,并打开 TikTok Seller / 附属会话 .

使用与 @dimension-studios/ttk-proxy。可公布的柏油球只包括编译 dist/ 财务报告和审定财务报表 bin/ ——没有数据库或内部单列密码.

所需资源

• 节点.js ~ 24(匹配单发;见重发) engines) (中文(简体) ).
• 全权证书 /ttk-proxy/* 端点(API URL + key + secret).
• 后端支持为 GET /ttk-proxy/shops/search?q= (与曝光TTK代理的节点API一起安装).

安装(CLI用户)

npm install -g @dimension-studios/shop-browser

用套件捆绑的 Playwright 版本安装 Chromium( 赤色) bunx playwright 拖出最新的 Playwright, 下载不同的 Chromium 构建 :

# npm global install
node "$(npm root -g)/@dimension-studios/shop-browser/node_modules/playwright-core/cli.js" install chromium
# bun global install (bun add -g)
bun ~/.bun/install/global/node_modules/playwright-core/cli.js install chromium

更新后再次运行 shop-browser 当它失败时 Executable doesn't exist at …/ms-playwright/chromium-<build>/…:新版可以撞倒Playwright并期望一个更新的建筑.

如果铬不能发射,则设定 EXECUTABLE_PATH 到您的 Chrome/ Chromium 可执行文件(以下记录) .

第一次设置

或设置环境变量(例如您在 shell profile 中),或通过捆绑的配置来坚持这些变量(与 UX 相同) @dimension-studios/ttk-proxy:

环境变量(建议)

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

然后验证:

shop-browser config

以配置 : set 保存证书

shop-browser config:set apiUrl "https://your-node-api.example.com"
shop-browser config:set apiKey "your-api-key"
shop-browser config:set apiSecret "your-api-secret"

shop-browser config --show

CLI 使用情况

运行 无参数 启动流量 :

shop-browser

1. 搜索商店的名称或弹片( 至少) 2个字符) (中文(简体) ). 调查结果只来自您授权的商店.
2. 选择一个目标页面(Seller Center,附属中心,支持消息).
3. 完成时关闭浏览器窗口;进程退出.

添加 -i 编号 : --allow-invalid 打开一个其储存的饼干不再被标记为有效的商店(失效的商店,过期的登录):

shop-browser --allow-invalid

可选环境

复制 .env.example 改为 .env 仅供地方发展之用;不犯真正的秘密.

要将 Chrome DevTools MCP 附加到打开的浏览器中, 使用调试端口启动 :

REMOTE_DEBUGGING_PORT=9222 shop-browser

然后将 Chrome DevTools MCP 配置为:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]
    }
  }
}

完成后关闭浏览器, 因此调试端口不再被曝光 .

帮助和版本

shop-browser --help
shop-browser --version
shop-browser config --help

浏览器扩展

该扩展会在 TikTok 域上向您现有的 Chrome 或 Firefox 浏览器注入商店 cookie(*.tiktok.com, (中文(简体) ), *.tiktokshop.com, (中文(简体) ), *.tiktokglobalshop.com) (中文(简体) ).

构建扩展 (Monorepo)

bun install
bun run --cwd tools/shop-browser build:extension

这产生了:

• tools/shop-browser/dist/extension/chrome - 已拆开的Chrome扩展
• tools/shop-browser/dist/extension/firefox —已解开的Firefox扩展名(用于调试)
• tools/shop-browser/dist/extension/dimension-shop-browser.xpi — Firefox 添加文件
• tools/shop-browser/dist/extension/dimension-shop-browser-chrome.zip —已拉链的Chrome扩展

扩展图标从 extension/icons/ (从 apps/app/public/icons/icon.svg) (中文(简体) ).

在 Chrome 安装

1. 打开 chrome://extensions
2. 启用 开发者模式
3. 点击 装入已卸出
4. 选择 tools/shop-browser/dist/extension/chrome

在 Firefox 中安装

要求数 消防狐127 或后会.

标准Firefox发布 : 正常放行时未署名的Mozilla区块会建起. 使用下面的临时安装流程进行本地开发,或者安装一个通过AMO或您的组织分发的签名的XPI. Firefox 清单宣布需要数据收集权限(authenticationInfo, (中文(简体) ), searchTerms),所以加成可以通过AMO验证,用于该已签名的分发路径.

永久安装( 未签名, 专用 Firefox 建筑):

仅在 Firefox 上使用 爱沙尼亚, (中文(简体) ), 开发者版, (中文(简体) ), 夜来,或者其他 无品牌 在允许未署名加注的地方建造。 在标准发布 Firefox, 设置 xpinstall.signatures.required 改为 false 已经 没有 允许永久未签名的安装.

1. 打开 about:config 设置 xpinstall.signatures.required 改为 false。 。 。 .
2. 打开 about:addons
3. 点击齿轮图标 {} 从文件安装添加..
4. 选择 tools/shop-browser/dist/extension/dimension-shop-browser.xpi

临时安装( 建议用于标准 Firefox; 重新启动时删除) :

1. 打开 about:debugging#/runtime/this-firefox
2. 点击 装入临时加载
3. 选择 tools/shop-browser/dist/extension/firefox/manifest.json

扩展使用

1. 用应用程序来源构建扩展名 tools/shop-browser/.env (单位:千美元)NEXT_PUBLIC_APP_URL,或 TTK_FETCH_API_URL 犹如退后.
2. 打开扩展名并单击 签名到尺寸 如果您尚未签名 app.dimensionstudios.co。 。 。 .
3. 搜索商店( 最少 2个字符)并选择. 结果仅限于您可以进入当前组织的商店.
4. 转弯 自动注入 当打开 TikTok 域时, 或使用时, 将插入 cookie 现在注射 手动.
5. 转动自动注射 关 停止未来的注入, 并让已有的浏览器 cookie 不受影响 .

IAM 许可

用户需要 使用商店浏览器扩展 权限( e)SHOP_BROWSER_EXTENSION_ACCESS),用于他们所注入的每一家商店. 组织管理人员可以从全组织或商店范围的IAM团体获得。 这个权限暴露出原始的TikTok shop会话 cookie,并有效地让用户在他们的浏览器中充当该商店的管理员——只给予信任的用户.

CLI 继续使用 API URL + key + secret(TTK_FETCH_API_*;只有浏览器扩展使用SaaS会话 cookie.

CI/CD发布

当 @dimension-studios/shop-browser 是通过 语义释放 打开 main-release。 。 。 .

线人做什么

1. 弹出 npm 软件包版本(与 CLI 相同的发布).
2. 以 NEXT_PUBLIC_APP_URL 从 GitHub 动作 vars (有线于 .github/workflows/release.yml) (中文(简体) ). 扩展列表版本来自 @dimension-studios/shop-browser package.json (与CI上的语义-放出版本相配合).
3. 附加释放文物到 GitHub 释放 :
   • dimension-shop-browser.xpi — Firefox 添加内容
   • dimension-shop-browser-chrome.zip - Chrome可拆卸扩展(上载至Chrome Web Store或已拆卸)

所需的 GitHub 配置

• 仓库变量 : NEXT_PUBLIC_APP_URL (例如:. https://app.dimensionstudios.co 用于生产释放物.

从释放安装

1. 打开 GitHub 发布 此重播页面.
2. 从最近下载 XPI 或 Chrome ZIP @dimension-studios/shop-browser 释放.
3. Firefox: (英语) 安装 XPI(签名的 AMO 分布仍需要单独的 Mozilla 提交) .
4. 颜色 : 上传 ZIP 到 Chrome Web Store 开发者仪表板,或卸下并装入行李进行内部测试.

CI 还运行 bun run --cwd tools/shop-browser build:extension 每一次拉动请求.github/workflows/check.yml) 早期捕捉到建立回归.

自动存储列表( Chrome + Firefox)

打开 main-release 只有在语义释放成功之后,CI才会将已建扩展提交:

• Chrome 网页存储器 ——通过上传+发布 chrome-webstore-upload-cli
• Firefox 添加子 (AMO) (英语) ——通过 web-ext sign (提交 API 在 Web-ext 8+ 中默认)

一次性开发者设置

Chrome 网页存储器

1. 在 Chrome Web Store 开发者仪表板 (第一次上传可以是手动的).
2. 启用 Chrome 网络存储 API 谷歌云计划.
3. 创建 OAuth 证书并生成刷新符号 - 铬-网球-上载键 穿过这个.
4. 请注意你 发布者 ID (开发仪表板)和 扩展代号 (从列表 URL 或 chrome://extensions 当装入行李时.

Firefox 添加点数

1. 创建附加于 (原始内容存档于2018-10-21). addons.mozila.org (名单).
2. 生成 JWT API证书 (发卡人+秘密)来自开发商枢纽.
3. 扩展名ID已经设置在 extension/manifest.firefox.json数字 : [email protected]。 。 。 .

GitHub 秘密( 存储)

如果缺少任何商店的秘密,该商店会被跳出(释放仍然成功). 两家店都要求各自保密.

手工商店出版(当地)

生产之后 NEXT_PUBLIC_APP_URL数字 :

export NEXT_PUBLIC_APP_URL=https://app.dimensionstudios.co
bun run --cwd tools/shop-browser build:extension

# Set the same SHOP_BROWSER_* secrets as in GitHub, then:
bun run --cwd tools/shop-browser publish:stores

新版本在提交后输入每个商店的审查队列;批准由Google/Mozilla处理.

发展(在这个单列中)

bun install
bun run --cwd tools/shop-browser build
bun run --cwd tools/shop-browser build:extension
bun run --cwd tools/shop-browser type-check

从源代码运行 CLI( expects env 通过 dotenv / 链接根 .env:

bun run --cwd tools/shop-browser start
# or from repo root:
bun run tools:isb

弹出/ 背景变化后重建扩展名 :

bun run --cwd tools/shop-browser dev:extension

然后在浏览器中重新装入已打开的扩展 .

相关软件包

• @dimension-studios/ttk-proxy ——从终端调用 TTK 代理 API,包括 ttk-proxy shops <query> 用于调试商店搜索.

许可证

公务员制度委员会

作者

尺寸工作室