show 展示
show_equities 等一次性拿全部证券列表。
Features
功能清单
官方 README 声明的主要能力。
| 能力 | 说明 |
|---|---|
| 证券展示 | show 系列一次性获取某类证券完整列表 |
| 条件筛选 | select 系列按国家/行业/板块/市值筛选 |
| 名称搜索 | search_products 按名称模糊搜索 |
| 七类证券 | 股票/ETF/基金/指数/货币/加密货币/货币市场 |
| DataFrame 返回 | 查询结果以 pandas DataFrame 返回 |
| 元数据字段 | 名称/代码/国家/行业/市值/货币等 |
Capabilities
三系 API 能力
show/select/search 各司其职。
select 筛选
按 country/sector/industry/market_cap 筛选。
search 搜索
search_products 按名称模糊搜索。
DataFrame
返回格式
所有查询返回 pandas DataFrame，便于二次分析。
| 返回 | 类型 | 内容 |
|---|---|---|
show_equities() | DataFrame | 全部股票代码与元数据 |
select_equities(...) | DataFrame | 筛选后的股票子集 |
search_products(...) | DataFrame | 匹配名称的证券候选 |
说明：DataFrame 可导出 CSV、接入下游管道，或配合 FinanceToolkit/yfinance 获取行情。
Limitations
限制与边界
选型前需了解的能力边界。
| 限制 | 影响 |
|---|---|
| 不提供行情价格 | 只有代码/元数据，行情需另配 FinanceToolkit 或 yfinance |
| 字段可能滞后 | 市值等字段依赖数据源，可能滞后于实时市场 |
| 以美股等数据源为主 | A 股覆盖有限，需另找数据源 |
| 证券列表不构成投资建议 | 仅提供证券代码与元数据查询 |
结论：FinanceDatabase 适合「找证券代码、按条件筛选证券池、按名称查代码」的数据准备场景；行情与回测需另配数据源与框架。
Pairing
与行情源配合
FinanceDatabase 常与其他库配合使用。
FinanceToolkit
同作者工具，拿证券代码后做基本面分析。
yfinance
拿代码后调用 yfinance 获取行情。
数据管道
证券列表导出 CSV，接入下游 ETL 管道。
说明：以上为一般性配合方式，具体接入请结合各自文档核验。
FAQ
功能特性常见问题
FinanceDatabase 是行情数据源吗？
不是。它是证券代码/元数据数据库，不提供行情价格。
能筛选 A 股吗？
FinanceDatabase 以美股等数据源为主；A 股筛选可看 EasyClaw 的 akshare-finance/tushare-finance Skill。
DataFrame 能导出吗？
能。查询结果是 pandas DataFrame，可 to_csv 导出或接入下游管道。
为什么不做行情？
FinanceDatabase 定位是证券列表/元数据查询，行情与基本面由 FinanceToolkit 等配套工具负责。