Skip to main content

安装

npm install reportify-sdk

快速开始

import { Reportify } from 'reportify-sdk';

// 初始化客户端
const client = new Reportify({ apiKey: 'your-api-key' });

// 搜索文档
const docs = await client.search('Tesla earnings', { num: 10 });
docs.forEach(doc => console.log(doc.title));

// 获取股票财务数据
const income = await client.stock.incomeStatement('US:AAPL', { period: 'quarterly' });
console.log(income);

特性

文档搜索

支持多种文档类型搜索:新闻、研报、公告、电话会议纪要等

股票数据

获取财务报表、行情数据,完整类型定义

时间线

获取关注公司、主题、机构的最新动态

知识库

搜索用户上传的私有文档

配置选项

apiKey
string
required
你的 Reportify API 密钥,可在开发者中心获取
baseUrl
string
default:"https://api.reportify.cn"
API 基础 URL,通常不需要修改
timeout
number
default:"30000"
请求超时时间(毫秒)

错误处理

import { 
  Reportify, 
  AuthenticationError, 
  RateLimitError, 
  NotFoundError, 
  APIError 
} from 'reportify-sdk';

try {
  const docs = await client.search('Tesla');
} catch (error) {
  if (error instanceof AuthenticationError) {
    console.error('API Key 无效');
  } else if (error instanceof RateLimitError) {
    console.error('请求过于频繁,请稍后重试');
  } else if (error instanceof NotFoundError) {
    console.error('资源不存在');
  } else if (error instanceof APIError) {
    console.error(`API 错误: ${error.message}`);
  }
}

TypeScript 支持

SDK 提供完整的 TypeScript 类型定义:
import type { 
  Document, 
  SearchOptions, 
  IncomeStatement,
  BalanceSheet,
  TimelineItem 
} from 'reportify-sdk';

const options: SearchOptions = {
  num: 10,
  categories: ['news', 'reports'],
  symbols: ['US:TSLA']
};

const docs: Document[] = await client.search('Tesla', options);

ESM 和 CommonJS

SDK 同时支持 ES Modules 和 CommonJS:
import { Reportify } from 'reportify-sdk';

下一步