Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -532,6 +532,32 @@
"cli",
"oauth2"
]
},
{
"name": "upkuajing",
"version": "1.0.5",
"description": "Search B2B companies, contacts and trade data, and enrich leads with UpKuaJing. Paid queries require a quote and confirmation.",
"description_i18n": {
"en": "Search B2B companies, contacts and trade data, and enrich leads with UpKuaJing. Paid queries require a quote and confirmation.",
"zh-CN": "通过跨境魔方搜索 B2B 企业、职业联系人和海关贸易数据,按需补全线索;收费查询执行前报价并确认。"
},
"source": "./plugins/upkuajing",
"author": {
"name": "UpKuaJing"
},
"category": "productivity",
"keywords": [
"b2b",
"trade",
"leads",
"mcp"
],
"icon": "https://www.upkuajing.com/favicon.ico",
"displayName": "UpKuaJing",
"displayName_i18n": {
"en": "UpKuaJing",
"zh-CN": "跨境魔方"
}
}
]
}
8 changes: 8 additions & 0 deletions plugins/upkuajing/.mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"upkuajing": {
"type": "http",
"url": "https://mcp.upkuajing.com/mcp"
}
}
}
22 changes: 22 additions & 0 deletions plugins/upkuajing/.zcode-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
{
"name": "upkuajing",
"version": "1.0.5",
"description": "Search B2B companies, contacts and trade data, and enrich leads with UpKuaJing. Paid queries require a quote and confirmation.",
"description_i18n": {
"en": "Search B2B companies, contacts and trade data, and enrich leads with UpKuaJing. Paid queries require a quote and confirmation.",
"zh-CN": "通过跨境魔方搜索 B2B 企业、职业联系人和海关贸易数据,按需补全线索;收费查询执行前报价并确认。"
},
"author": {
"name": "UpKuaJing"
},
"keywords": [
"b2b",
"trade",
"leads",
"contacts",
"mcp"
],
"skills": "./skills",
"mcpServers": "./.mcp.json",
"license": "MIT"
}
21 changes: 21 additions & 0 deletions plugins/upkuajing/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 UpKuaJing

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
47 changes: 47 additions & 0 deletions plugins/upkuajing/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
<img src="icon.svg" alt="UpKuaJing" width="64" height="64">

# UpKuaJing

Use a remote MCP server in ZCode to search B2B companies, professional contacts, customs trade records and map businesses, enrich contact details, analyze existing leads, and handle explicitly requested email/SMS delivery and task queries.

Plugin version: `1.0.5`. The package contains a remote MCP declaration and one `upkuajing` skill. Available tools and parameters are determined by the schemas discovered after connection.

## Installation and authorization

1. Locate UpKuaJing in the ZCode plugin marketplace once published. For local testing, add the marketplace directory containing `marketplace.json` and `plugins/upkuajing/`.
2. Install and enable UpKuaJing, then open a conversation.
3. Open ZCode's MCP management interface and complete UpKuaJing OAuth login. Ask the ZCode agent if you need help. An UpKuaJing account and appropriate permissions are required; paid capabilities also require available quota.
4. After authorization, ask “Check my UpKuaJing balance” and confirm that `auth_info` can be discovered and called.

The package declares a remote HTTP MCP endpoint. OAuth login, credential refresh and tool calls in ZCode still require runtime verification. If the client has no authorization entry or cannot complete login, the connection is unavailable. Retain the error for diagnosis; do not paste tokens, passwords or cookies into chat.

## Examples

- “Find US companies related to ice machines. Show the plan and maximum cost first.”
- “Find US buyers of ice machines using customs trade records.”
- “Enrich my selected companies with emails and phone numbers after confirming the cost.”
- “Check my UpKuaJing account balance and available quota.”
- “Check the status of my previous email task.”

The skill provides guidance for relevant requests. Paid actions require live pricing, a plan with a maximum cost, and explicit approval in the user's next turn. It does not automatically expand queries or retry paid requests. Email/SMS delivery also requires confirmation of recipients, content, channel and cost.

## Dependencies, network access and side effects

- Requires ZCode with plugin and remote HTTP MCP support, plus network access to `https://mcp.upkuajing.com/mcp`. OAuth also accesses the authorization endpoints actually advertised by the service.
- The package does not include MCP server source code and requires no local Python, Node.js or additional model API key. The ZCode session supplies the model; data capabilities depend on the online UpKuaJing service.
- Tool calls send query conditions, business IDs, enrichment inputs, and approved recipients and message content to UpKuaJing for processing. Only provide data you are authorized to share.
- Search, enrichment and verification tools may consume account quota. Current tool responses determine pricing. Email/SMS delivery reaches real third parties; reading task status does not send again.
- The plugin contains no local executable scripts, command components or hooks, and declares no automatic project-file writes. ZCode installs the package and manages its own configuration and authorization state. Separately requested exports or saves follow that request.
- MCP App graphical rendering compatibility is unverified. When display support is unknown or unavailable, the skill falls back to text or Markdown using existing results instead of issuing another paid query.

## Sources and licensing

UpKuaJing provides the MCP service. The skill is adapted from this project's WorkBuddy distribution. The bundled icon.svg is the UpKuaJing logo copied from the WorkBuddy package. No third-party executable code is bundled. The packaging format follows the [official ZCode plugin repository](https://github.com/zai-org/zcode-plugins).

The plugin configuration, documentation and skill are distributed under the [MIT License](LICENSE). The UpKuaJing logo is included for identifying this integration; the MIT license does not grant trademark rights or rights to hosted services and business datasets. Service access remains subject to applicable account terms and fees.

## Verification scope

Official validation and distribution build checks passed. Local installation, enablement, Chinese display name and logo display were confirmed in ZCode. End-to-end OAuth login/refresh, authenticated balance lookup and business-result rendering have not passed acceptance yet; authorization timed out during an attempted connection. No paid query or message delivery was performed as part of this verification.

Minimal manual check: install and authorize as above, then request the balance; `auth_info` should return the current account information. Next request a search plan; the agent should obtain guidance and pricing and stop for cost confirmation without executing a paid search. Paid queries and actual delivery require separate explicit approval.
47 changes: 47 additions & 0 deletions plugins/upkuajing/README_CN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
<img src="icon.svg" alt="UpKuaJing" width="64" height="64">

# 跨境魔方 / UpKuaJing

在 ZCode 中通过远程 MCP 搜索 B2B 企业、职业联系人、海关贸易记录和地图商户,按需补全联系方式、分析已有线索,并处理用户明确要求的邮件、短信发送及任务查询。

插件版本:`1.0.5`。插件包含远程 MCP 声明和一个 `upkuajing` Skill;具体工具及参数以连接后实际发现的 Schema 为准。

## 安装与授权

1. 正式上架后,在 ZCode 插件市场查找跨境魔方。本地测试时,添加包含 `marketplace.json` 和 `plugins/upkuajing/` 的市场目录。
2. 获取并启用跨境魔方插件,进入对话。
3. 前往 ZCode 的 MCP 管理功能,完成跨境魔方 OAuth 登录。需要帮助时可询问 ZCode Agent。需要可用账号及相应权限;收费能力还需要可用额度。
4. 授权后请求「查看我的跨境魔方账户余额」,确认能发现并调用 `auth_info`。

本包已声明远程 HTTP MCP 地址,但 ZCode 的 OAuth 登录、凭据刷新和工具调用仍需实际验证。如果客户端没有授权入口或无法完成登录,连接尚不可用;请保留错误信息供排查,不要在聊天中粘贴 Token、密码或 Cookie。

## 使用示例

- 「查找美国制冰机相关企业,先说明方案和最高费用。」
- 「根据海关贸易记录寻找采购制冰机的美国采购商。」
- 「补全我选中企业的邮箱和电话,先确认费用。」
- 「查看我的跨境魔方账户余额和可用额度。」
- 「查看刚才邮件任务的发送状态。」

Skill 在相关需求出现时提供调用指导。收费操作先获取实时价格、展示计划与最高费用,并等待用户下一轮明确同意;不自动扩大查询或重试收费请求。发送邮件或短信前还要确认实际目标、内容、渠道和费用。

## 依赖、网络与副作用

- 需要支持插件和远程 HTTP MCP 的 ZCode,以及访问 `https://mcp.upkuajing.com/mcp` 的网络。OAuth 还需要访问服务端实际公布的授权端点。
- 插件包不包含 MCP 服务端源码,也不需要本地 Python、Node.js 或额外模型 API Key;模型由 ZCode 会话提供,数据能力依赖跨境魔方在线服务。
- 调用会把查询条件、业务 ID、补全输入,以及用户批准的收件人和消息内容发送至跨境魔方服务处理。不要输入无权提供的数据。
- 搜索、补全、校验等工具可能消耗账户额度,价格以实时工具返回为准。邮件、短信发送会真实触达第三方;任务读取不等于重新发送。
- 本插件不包含本地可执行脚本、命令组件或 Hooks,也不声明自动写入项目文件的行为。ZCode 会安装插件并管理自身配置及授权状态;用户另行要求的导出或保存按该请求处理。
- MCP App 图形展示兼容性尚未验证。展示能力未知或不可用时,Skill 使用已有结果进行文本或 Markdown 回退,不为展示重新发起收费查询。

## 来源与许可证

MCP 服务由 UpKuaJing 提供;Skill 改编自本项目的 WorkBuddy 分发版本。随包的 icon.svg 为从 WorkBuddy 分发包原样复制的跨境魔方 logo;未打包第三方可执行代码。ZCode 包装格式参考 [ZCode 官方插件仓库](https://github.com/zai-org/zcode-plugins)。

插件配置、文档和 Skill 使用 [MIT 许可证](LICENSE)。跨境魔方 logo 仅用于标识本集成;MIT 不授予商标权,也不授予在线服务或业务数据的使用权。服务访问仍受账号条款和费用规则约束。

## 验证范围

官方校验与分发构建已通过。已在 ZCode 确认本地安装、启用、中文名称及图标显示正常。OAuth 登录与刷新、授权后的余额查询及业务结果展示尚未验收通过;一次连接尝试出现授权超时。本次验证未执行收费查询或消息发送。

最小手动验证:按上文安装授权后请求账户余额,预期 `auth_info` 返回当前账户信息;再要求一项搜索方案,预期先获取指导与价格并停在费用确认处,不执行收费搜索。付费查询和实际发送需另行明确批准。
11 changes: 11 additions & 0 deletions plugins/upkuajing/icon.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading