Contract
input_schema.json
{
"type": "object",
"anyOf": [
{
"required": [
"start_date"
]
},
{
"required": [
"end_date"
]
},
{
"required": [
"category_code"
]
},
{
"required": [
"city_code"
]
}
],
"properties": {
"end_date": {
"type": "integer",
"default": 1735488000,
"description": "快照结束时间 格式10位时间戳"
},
"city_code": {
"type": "string",
"default": "",
"description": "城市编码，从城市列表获取，空为全部"
},
"start_date": {
"type": "integer",
"default": 1734902400,
"description": "快照开始时间 格式10位时间戳"
},
"category_code": {
"type": "string",
"default": "",
"description": "热点榜分类编码，从热点榜分类获取，空为全部"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"code": {
"type": "number",
"description": "0 on every real call observed."
},
"data": {
"type": "object",
"properties": {
"event_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "The event's own id."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Observed as an empty array on every real call."
},
"end_date": {
"type": "number",
"description": "Unix seconds."
},
"sentence": {
"type": "string",
"description": "Observed as an empty string on every real call."
},
"timeline": {
"type": "null",
"description": "Observed `null` on every real call."
},
"city_name": {
"type": "string",
"description": "City this event is scoped to, when the call is narrowed by `city_code`. Observed as an empty string on every real call (none passed `city_code`)."
},
"cover_url": {
"type": [
"string",
"null"
],
"description": "Cover image URL. Withheld (shaped to `null`) -- only whether an event has a cover image is observable, not the image itself."
},
"event_ids": {
"type": "null",
"description": "Observed `null` on every real event entry (unlike a topic's own `event_ids`)."
},
"hot_title": {
"type": "string",
"description": "The trending headline, in Chinese."
},
"parent_id": {
"type": "number",
"description": "The id of the topic this event rolls up under, or 0 for none."
},
"level_code": {
"type": "number",
"description": "Platform-assigned ranking tier."
},
"start_date": {
"type": "number",
"description": "Unix seconds."
},
"is_favorite": {
"type": "number",
"description": "0 or 1; observed 0 on every real call."
},
"publish_cnt": {
"type": "number",
"description": "0 observed on every real call."
},
"event_status": {
"type": "number",
"description": "-1 observed on every real call."
},
"category_name": {
"type": "string",
"description": "Content category, in Chinese, e.g. '美食' (food), '话题互动' (topic engagement)."
},
"related_topics": {
"type": "string",
"description": "Observed as an empty string on every real call."
}
},
"additionalProperties": true
},
"description": "Individual trending events, each tied to a parent topic via `parent_id`. ABSENT entirely -- not present as `null`, not `[]` -- when the requested date range has nothing scheduled (confirmed on the narrow-window-empty fixture: the upstream body's own `null` is dropped by the field-map allowlist at this array-typed node, so no `event_list` key reaches the customer at all in that case). Do not rely on this key being present; check for its absence to detect \"nothing scheduled\", not for a `null` value."
},
"topic_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Observed as an empty array on every real call."
},
"end_date": {
"type": "number",
"description": "Unix seconds."
},
"sentence": {
"type": "string",
"description": "Observed as an empty string on every real call."
},
"timeline": {
"type": "null",
"description": "Observed `null` on every real call."
},
"city_name": {
"type": "string",
"description": "Observed as an empty string on every real topic entry."
},
"cover_url": {
"type": "string",
"description": "Observed as an empty string on every real topic entry."
},
"event_ids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Ids of the events grouped under this topic."
},
"hot_title": {
"type": "string",
"description": "The topic headline, in Chinese."
},
"parent_id": {
"type": "number",
"description": "0 observed on every real call."
},
"level_code": {
"type": "number"
},
"start_date": {
"type": "number",
"description": "Unix seconds."
},
"is_favorite": {
"type": "number",
"description": "0 observed on every real call."
},
"publish_cnt": {
"type": "number",
"description": "0 observed on every real call."
},
"event_status": {
"type": "number",
"description": "-1 observed on every real call."
},
"category_name": {
"type": "string",
"description": "Observed as an empty string on every real topic entry."
},
"related_topics": {
"type": "string",
"description": "Observed as an empty string on every real call."
}
},
"additionalProperties": true
},
"description": "Parent topics that group one or more events (see each event's `parent_id`). ABSENT entirely -- not present as `null`, not `[]` -- when the requested date range has nothing scheduled, for the same field-map-allowlist reason as `event_list` above. Do not rely on this key being present; check for its absence to detect \"nothing scheduled\"."
}
},
"additionalProperties": true
},
"extra": {
"type": "object",
"properties": {
"now": {
"type": "number",
"description": "The upstream server's own clock at call time, unix milliseconds."
}
},
"description": "Call metadata.",
"additionalProperties": true
},
"message": {
"type": "string",
"description": "Observed as an empty string on every real call."
}
},
"description": "The calendar record, as returned at routing.responseResultPath ($.output). The raw upstream body carries `data.event_list`/`data.topic_list` as `null` (not `[]`) when nothing is scheduled for the requested date range, but `responseShaping`'s field-map allowlist treats a `null` at an array-typed allowlist node as \"omit the key entirely\" -- so `data.event_list` and `data.topic_list` are ABSENT from what this tool actually hands back in that case, never present as `null` -- confirmed against the narrow-window-empty fixture and this catalog's own field-map mechanism (see `data` below).",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.0020475 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 23, 2026