longbridge-calendar

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

longbridge-calendar

Forward-looking calendar of corporate and macro events: earnings, dividends, IPOs, macro data, and market closures.

Response language: match the user's input language — Simplified Chinese / Traditional Chinese / English.

企业与宏观事件前瞻性日历：涵盖财报、股息、IPO、宏观数据以及市场休市信息。

响应语言：匹配用户输入语言——简体中文/繁体中文/英文。

When to use

使用场景

"下周哪些公司财报", "NVDA 下次财报什么时候", "earnings next week" →
```
report
```
(or
```
financial
```
)
"AAPL 下次除息日", "港股下周派息", "ex-dividend dates" →
```
dividend
```
"下周有什么新股", "美股 IPO 日历", "upcoming IPOs" →
```
ipo
```
"下周非农", "CPI 什么时候", "FOMC 议息", "macro calendar" →
```
macrodata
```
(use
```
--star 3
```
for top-importance only)
"美股下周休市吗", "market holidays" →
```
closed
```
"下周市场全景" → call
```
report
```
+
```
dividend
```
+
```
macrodata --star 3
```
concurrently

For a single stock's historical earnings →

longbridge-fundamental

. For watchlist-driven daily briefings →

longbridge-catalyst-radar

"下周哪些公司财报"、"NVDA 下次财报什么时候"、"earnings next week" → 调用
```
report
```
（或
```
financial
```
）
"AAPL 下次除息日"、"港股下周派息"、"ex-dividend dates" → 调用
```
dividend
```
"下周有什么新股"、"美股 IPO 日历"、"upcoming IPOs" → 调用
```
ipo
```
"下周非农"、"CPI 什么时候"、"FOMC 议息"、"macro calendar" → 调用
```
macrodata
```
（仅需高重要性事件时添加
```
--star 3
```
）
"美股下周休市吗"、"market holidays" → 调用
```
closed
```
"下周市场全景" → 同时调用
```
report
```
+
```
dividend
```
+
```
macrodata --star 3
```

如需查询单只股票的历史财报数据 → 使用

longbridge-fundamental

。如需基于自选股的每日简报 → 使用

longbridge-catalyst-radar

。

Subcommands

子命令

Run
longbridge finance-calendar --help
if unsure of current flags. The CLI's built-in help is the canonical source.

A single command handles all event types:

longbridge finance-calendar <EVENT_TYPE> [OPTIONS]

`<EVENT_TYPE>`	Returns
`financial`	Financial-period events.
`report`	Earnings releases (V2 rule: includes `financial` automatically).
`dividend`	Dividend ex-dates / pay-dates.
`ipo`	Upcoming initial public offerings.
`macrodata`	Macro data releases (CPI / NFP / FOMC / GDP / etc.). Use `--star 1\|2\|3` (repeatable) to filter by importance.
`closed`	Market closure days.

Common options:

Flag	Meaning
`--symbol <SYM>`	Filter by symbol; repeatable up to 10. With `--symbol` , default start date is 3 months ago; without, today.
`--market <MKT>`	Filter by market: `HK / US / CN / SG / JP / UK / DE / AU` ; repeatable.
`--start YYYY-MM-DD`	Start date. Default: today (or 3 months ago when `--symbol` is set).
`--end YYYY-MM-DD`	End date. Default: no limit.
`--count N`	Max events (default 100).
`--star 1\|2\|3`	Macro importance, repeatable. Only effective for `macrodata` .
`--next later\|earlier`	Pagination direction (default `later` ).
`--offset N`	Pagination offset.
`--format json\|table`	Output format.

若不确定当前参数，可运行
longbridge finance-calendar --help
。CLI内置帮助为权威参考来源。

单个命令即可处理所有事件类型：

longbridge finance-calendar <EVENT_TYPE> [OPTIONS]

`<EVENT_TYPE>`	返回内容
`financial`	财务周期相关事件。
`report`	财报发布（V2规则：自动包含 `financial` 类事件）。
`dividend`	股息除息日/派息日。
`ipo`	即将到来的首次公开募股（IPO）。
`macrodata`	宏观数据发布（CPI/NFP/FOMC/GDP等）。可使用 `--star 1\|2\|3` （可重复使用）按重要性筛选。
`closed`	市场休市日。

通用选项：

参数	说明
`--symbol <SYM>`	按标的代码筛选；最多可重复10次。使用该参数时，默认起始日期为3个月前；未使用时默认起始日期为今日。
`--market <MKT>`	按市场筛选： `HK / US / CN / SG / JP / UK / DE / AU` ；可重复使用。
`--start YYYY-MM-DD`	起始日期。默认值：今日（使用 `--symbol` 时为3个月前）。
`--end YYYY-MM-DD`	结束日期。默认值：无限制。
`--count N`	最大返回事件数（默认100）。
`--star 1\|2\|3`	宏观事件重要性，可重复使用。仅对 `macrodata` 生效。
`--next later\|earlier`	分页方向（默认 `later` ）。
`--offset N`	分页偏移量。
`--format json\|table`	输出格式。

Workflow

工作流程

Pick
```
<EVENT_TYPE>
```
from the prompt cue.
Decide scope:
```
--symbol
```
(1–10 specific tickers) and/or
```
--market
```
(one or more markets).

Decide window:

--start

--end

. For "next week" use

--start <today> --end <today+7>

For macro: add
```
--star 3
```
(or 2,3) when the user wants high-impact only.
Call the CLI; render a date-grouped table.
Cite Longbridge Securities and the queried date range.

根据提示选择
```
<EVENT_TYPE>
```
。
确定查询范围：
```
--symbol
```
（1-10个特定标的代码）和/或
```
--market
```
（一个或多个市场）。
确定时间窗口：
```
--start
```
/
```
--end
```
。如需查询“下周”，使用
```
--start <今日> --end <今日+7>
```
。
宏观事件查询：当用户仅需高影响事件时，添加
```
--star 3
```
（或2,3）。
调用CLI；按日期分组渲染表格。
标注数据来源为长桥证券及查询的日期范围。

CLI

CLI 示例

bash

undefined

bash

undefined

Earnings releases for the next 14 days, US + HK

查询未来14天美国+香港市场的财报发布

longbridge finance-calendar report --market US --market HK --end 2026-05-12 --format json

Specific tickers' upcoming earnings

查询特定标的即将发布的财报

longbridge finance-calendar financial --symbol AAPL.US --symbol TSLA.US --format json

This month's ex-dividend dates in US

查询本月美国市场的除息日

longbridge finance-calendar dividend --market US --format json

High-importance macro (FOMC / CPI / NFP)

查询高重要性宏观事件（FOMC/CPI/NFP）

longbridge finance-calendar macrodata --star 3 --format json

Upcoming IPOs in HK

查询香港市场即将到来的IPO

longbridge finance-calendar ipo --market HK --format json

Market closure days

查询市场休市日

longbridge finance-calendar closed --market US --format json


If `--help` shows newer flags, follow the help output rather than hard-coding here.

longbridge finance-calendar closed --market US --format json


若`--help`显示更新的参数，请以帮助输出为准，而非本文硬编码内容。

Output

输出格式

Render in the user's language. Suggested layouts:

report
/
financial
— table grouped by date: date / time (BMO/AMC if available) / symbol / company name / period / consensus EPS (if returned).

dividend
— table: ex-date / record date / pay date / symbol / amount / currency.

ipo
— table: subscription window / listing date / symbol / company / price range / market.

macrodata
— table: date+time / region / event / importance stars / forecast / previous (when available). Group by date.

closed
— list: date / market / reason (e.g. "Memorial Day", "中秋节").

When a result is empty for the chosen window, say so explicitly and offer to widen the window or check another market.

按用户使用的语言渲染。建议布局：

report
/
financial
— 按日期分组的表格：日期/时间（若有则标注盘前/盘后）/标的代码/公司名称/报告周期/市场一致预期EPS（若返回）。

dividend
— 表格：除息日/登记日/派息日/标的代码/股息金额/货币。

ipo
— 表格：认购窗口/上市日期/标的代码/公司名称/价格区间/市场。

macrodata
— 表格：日期+时间/地区/事件/重要性星级/预期值/前值（若有）。按日期分组。

closed
— 列表：日期/市场/休市原因（如*"Memorial Day"、"中秋节"*）。

若所选时间窗口无结果，请明确告知用户，并提供扩大时间窗口或更换市场的建议。

Error handling

错误处理

Situation	Reply
Shell `command not found: longbridge`	Fall back to MCP if configured; otherwise tell the user to install longbridge-terminal.
stderr `not logged in` / `unauthorized`	Hint `longbridge auth login` (the calendar is generally public, but auth may be required for some markets).
Empty result	State explicitly. Offer to widen the window or remove a filter.
Invalid date format	Re-prompt with `YYYY-MM-DD` .
Other stderr	Relay verbatim — never silently retry.

场景	回复内容
Shell 返回 `command not found: longbridge`	若已配置则 fallback 至MCP；否则告知用户安装longbridge-terminal。
stderr 返回 `not logged in` / `unauthorized`	提示用户执行 `longbridge auth login` （日历数据通常公开，但部分市场可能需要授权）。
无查询结果	明确告知用户，并提供扩大时间窗口或移除筛选条件的建议。
日期格式无效	重新提示用户使用 `YYYY-MM-DD` 格式。
其他stderr内容	直接转发内容——切勿静默重试。

MCP fallback

MCP 降级方案

When the CLI binary is missing, fall back via the equivalent MCP tool. Tool names typically mirror CLI subcommand names (snake_case).

CLI usage	MCP tool
`finance-calendar <event_type> ...`	`mcp__longbridge__finance_calendar` (event type passed as a parameter)

If the name above does not resolve, fall back via the equivalent MCP tool when CLI is missing.

当CLI二进制文件缺失时，通过等效的MCP工具降级处理。工具名称通常与CLI子命令名称一致（蛇形命名法）。

CLI 用法	MCP 工具
`finance-calendar <event_type> ...`	`mcp__longbridge__finance_calendar` （事件类型作为参数传入）

若上述名称无法解析，当CLI缺失时仍需通过等效MCP工具降级处理。

Related skills

Skill	Why
`longbridge-catalyst-radar`	Watchlist-scoped morning/evening briefings layered on this calendar.
`longbridge-earnings`	Single-symbol earnings deep-dive once the date arrives.
`longbridge-fundamental`	Historical earnings KPIs (the past counterpart).
`longbridge-news`	Filings and headline reaction around the event.

技能	关联原因
`longbridge-catalyst-radar`	基于本日历的自选股专属早晚简报。
`longbridge-earnings`	财报发布日当天的单标的财报深度分析。
`longbridge-fundamental`	历史财报关键指标查询（本工具的“过往数据”对应功能）。
`longbridge-news`	事件相关的公告及头条舆情。

File layout

文件结构

longbridge-calendar/
└── SKILL.md          # prompt-only, no scripts/

longbridge-calendar/
└── SKILL.md          # 仅含提示信息，无scripts/目录

longbridge-calendar

Original

Translation

longbridge-calendar

longbridge-calendar

When to use

使用场景

Subcommands

子命令

Workflow

工作流程

CLI

CLI 示例

Earnings releases for the next 14 days, US + HK

查询未来14天美国+香港市场的财报发布

Specific tickers' upcoming earnings

查询特定标的即将发布的财报

This month's ex-dividend dates in US

查询本月美国市场的除息日

High-importance macro (FOMC / CPI / NFP)

查询高重要性宏观事件（FOMC/CPI/NFP）

Upcoming IPOs in HK

查询香港市场即将到来的IPO

Market closure days

查询市场休市日

Output

输出格式

Error handling

错误处理

MCP fallback

MCP 降级方案

Related skills

相关技能

File layout

文件结构