Metadata-Version: 2.4
Name: zerone-cli
Version: 0.1.4
Summary: Zerone 私募股权数据 CLI 工具
Author-email: Zerone <tech@zerone.com.cn>
License: MIT
Project-URL: Homepage, https://ai.zerone.com.cn
Project-URL: Documentation, https://ai.zerone.com.cn
Keywords: cli,private-equity,finance,mcp,zerone
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.9.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: pandas>=2.0.0

# Zerone CLI

Zerone 私募股权数据命令行工具，通过 API Key 直接查询 Zerone 数据平台。

## 安装

```bash
pip install zerone-cli
```

## 快速开始

### 1. 配置 API Key

```bash
zerone config set-api-key YOUR_API_KEY
```

> 如何获取 API Key？请访问 [https://ai.zerone.com.cn](https://ai.zerone.com.cn) 注册账号后申请。

### 2. 查看帮助

```bash
zerone --help
```

### 3. 开始查询

```bash
# 实体模糊搜索
zerone entity-search "字节跳动"

# 查询实体综合画像
zerone entity-profile "中国石油"

# 查询实体财务数据列表
zerone entity-financial-list "中国石油" --page 1 --page-size 20

# 查询管理基金列表
zerone entity-managed-funds-list "深创投" --page 1 --page-size 20

# 查询退出列表
zerone entity-exit-list "深创投" --exit-type FUND --page 1 --page-size 20

# 查询投资列表
zerone entity-invest-list "深创投" --invest-type COMPANY --page 1 --page-size 20

# 查询融资概率预测
zerone model-financing-probability "字节跳动" --type COMPANY

# 查询机构匹配推荐
zerone model-company-match-gp "字节跳动" --page 1 --page-size 5

# 查询市场投融资事件
zerone evt-company-financing --start-date 2024-01-01 --end-date 2024-12-31 --province 北京 --city 北京市 --tag 人工智能 --page 1 --page-size 20

# 查询LP出资事件
zerone evt-lp-investment --start-date 2024-01-01 --end-date 2024-12-31 --province 广东 --city 深圳 --page 1 --page-size 20

# 查询老股转让事件
zerone evt-company-secondary --start-date 2024-01-01 --end-date 2024-12-31 --province 上海 --tag 半导体 --page 1 --page-size 20

# 查询回购事件
zerone evt-company-repurchase --start-date 2024-01-01 --end-date 2024-12-31 --province 浙江 --tag 医疗健康 --page 1 --page-size 20

# 查询并购事件
zerone evt-ma-company-deal --start-date 2024-01-01 --end-date 2024-12-31 --province 北京 --tag 新能源 --page 1 --page-size 20

# 查询IPO事件
zerone evt-company-ipo --start-date 2024-01-01 --end-date 2024-12-31 --province 广东 --tag 新材料 --page 1 --page-size 20

# 查询解禁事件
zerone evt-listing-company-unlock --start-date 2024-01-01 --end-date 2024-12-31 --province 江苏 --tag 高端制造 --page 1 --page-size 20

# 查询减持事件
zerone evt-listing-company-reduction --start-date 2024-01-01 --end-date 2024-12-31 --province 上海 --tag 集成电路 --page 1 --page-size 20

# 查询S基金交易事件
zerone evt-s-fund-deal --start-date 2024-01-01 --end-date 2024-12-31 --province 北京 --page 1 --page-size 20
```

## 命令列表

| 命令 | 说明 |
|------|------|
| `zerone config set-api-key` | 设置 API Key |
| `zerone config set-server-url` | 设置服务器地址（可选） |
| `zerone config show` | 查看当前配置 |
| `zerone entity-search` | 实体模糊搜索 |
| `zerone entity-profile` | 查询实体综合画像 |
| `zerone entity-financial-list` | 查询实体财务数据列表（分页） |
| `zerone entity-managed-funds-list` | 查询管理基金列表（分页） |
| `zerone entity-exit-list` | 查询退出列表（分页） |
| `zerone entity-invest-list` | 查询投资列表（分页） |
| `zerone model-financing-probability` | 查询融资概率预测模型 |
| `zerone model-company-match-gp` | 基于推荐引擎为项目公司匹配潜在投资机构 |
| `zerone evt-company-financing` | 查询市场投融资事件列表 |
| `zerone evt-lp-investment` | 查询LP出资事件列表 |
| `zerone evt-company-secondary` | 查询老股转让事件列表 |
| `zerone evt-company-repurchase` | 查询回购事件列表 |
| `zerone evt-ma-company-deal` | 查询并购事件列表 |
| `zerone evt-company-ipo` | 查询IPO事件列表 |
| `zerone evt-listing-company-unlock` | 查询解禁事件列表 |
| `zerone evt-listing-company-reduction` | 查询减持事件列表 |
| `zerone evt-s-fund-deal` | 查询S基金交易事件列表 |

## 常用参数说明

### 日期参数
- `--start-date`: 开始日期，格式 YYYY-MM-DD
- `--end-date`: 结束日期，格式 YYYY-MM-DD

### 地区参数
- `--province`: 省级行政区划
- `--city`: 地级行政区划
- `--county`: 县级行政区划

### 分页参数
- `--page`: 页码，从1开始，默认1
- `--page-size`: 每页条数，默认20，上限20

### 其他参数
- `--tag`: 公司标签（经营业务类）
- `--output`: 输出格式，可选 table/json/csv，默认table

## 配置说明

配置文件保存在 `~/.zerone/config.yaml`，支持以下环境变量覆盖：

| 环境变量 | 说明 |
|----------|------|
| `ZERONE_API_KEY` | API Key |
| `ZERONE_SERVER_URL` | 服务器地址 |

## 系统要求

- Python 3.9+
- 有效的 Zerone API Key

## 许可证

MIT
