Skip to main content

CLI wrapper for Reportify SDK - Access Reportify API through command line

Project description

Reportify API CLI

Access all Reportify SDK features via command line.

Features

  • Complete coverage of all 8 SDK modules with 44+ methods
  • Multiple output formats: JSON, Table, CSV, Markdown
  • Simple unified JSON input format with clear help documentation
  • AI-friendly design with detailed parameter descriptions

Installation

# Install dependencies and CLI
make install

# Or install directly with uv
uv pip install -e .

Configuration

Set API Key (required):

# Option 1: Environment variable
export REPORTIFY_API_KEY='your-api-key'

# Option 2: .env file
echo "REPORTIFY_API_KEY=your-api-key" > .env

Quick Start

# Show help
reportify-cli --help
reportify-cli -h

# Show module help
reportify-cli docs --help

# Show command help
reportify-cli docs get --help

# Get document details (JSON format)
reportify-cli docs get --input '{"doc_id": "1214713494948155392"}'

# Get stock quote (Table format)
reportify-cli stock quote --input '{"symbol": "600519"}' --format table

# Get financial data (Markdown format)
reportify-cli stock income_statement \
  --input '{"symbol": "600519", "period": "annual"}' \
  --format markdown

Available Modules

Module Description Commands
search Document search 9
docs Document management 4
stock Stock data 14
timeline Timeline 5
kb Knowledge base 1
user User data 1
quant Quantitative analysis 8
concepts Concept dynamics 2

Output Formats

4 output formats supported:

  • --format json - JSON (default)
  • --format table - Table
  • --format csv - CSV
  • --format markdown or --format md - Markdown table

Development

# Show all available commands
make help

# Run tests
make test

# Run unit tests
make test-unit

# Run integration tests (requires API Key)
make test-integration

# Format code
make format

# Lint code
make lint

# Clean cache
make clean

# Reinstall
make reinstall

Project Structure

reportify-cli/
├── src/                    # Source code
│   ├── main.py            # CLI entry point
│   ├── commands/          # Command modules
│   ├── client.py          # SDK client
│   ├── output.py          # Output formatting
│   ├── params.py          # Parameter definitions
│   ├── settings.py        # Configuration
│   └── utils.py           # Utilities
├── tests/                 # Tests
│   ├── test_commands/     # Unit tests
│   └── integration/       # Integration tests
├── Makefile              # Dev commands
├── pyproject.toml        # Project config
└── README.md             # Documentation

Examples

Search Documents

reportify-cli search query \
  --input '{"query": "Tesla earnings", "limit": 10}'

Stock Data

# Company overview
reportify-cli stock overview --input '{"symbol": "600519"}'

# Financial statements
reportify-cli stock income_statement \
  --input '{"symbol": "600519", "period": "annual"}'

# Stock prices
reportify-cli stock prices \
  --input '{"symbol": "600519", "start_date": "2024-01-01", "end_date": "2024-12-31"}'

Quantitative Analysis

# Compute factor values
reportify-cli quant compute_factors \
  --input '{"symbols": ["600519"], "formula": "RSI(14)", "market": "cn"}' \
  --format table

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

reportify_cli-0.1.48.tar.gz (74.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

reportify_cli-0.1.48-py3-none-any.whl (31.7 kB view details)

Uploaded Python 3

File details

Details for the file reportify_cli-0.1.48.tar.gz.

File metadata

  • Download URL: reportify_cli-0.1.48.tar.gz
  • Upload date:
  • Size: 74.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for reportify_cli-0.1.48.tar.gz
Algorithm Hash digest
SHA256 c09169a49ca7e6b3e45f85318a19afc87fc1c40cfcab86044c9323b83fe5f7f1
MD5 631b5aa63476e3233396fb859e1df230
BLAKE2b-256 e4f917df34ae0d3eb26af047d2ac9081b8ec9d3bca1b3eb6c19dccc4cfd33d98

See more details on using hashes here.

File details

Details for the file reportify_cli-0.1.48-py3-none-any.whl.

File metadata

  • Download URL: reportify_cli-0.1.48-py3-none-any.whl
  • Upload date:
  • Size: 31.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for reportify_cli-0.1.48-py3-none-any.whl
Algorithm Hash digest
SHA256 2765ee9e5d15d8aad0cf5e7b0d498aca6ba3959777cd3f8e343db0101512be94
MD5 a8d31ccf3ef41ccee85f2fa189d6fbd9
BLAKE2b-256 1f66399ff06d7a1922da79f46e51b74c290ffff31e48f4741ef1e9e6b30111a4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page