> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmquantdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 新闻浏览

> 按 ticker、事件、主题或日期浏览持续更新的公司新闻。

<Note icon="sparkles">
  **计划提供的 MCP 工具**：`news_browse` —— 上线后可在 Claude、Cursor 或其他 MCP 客户端中使用。配置方法见 [MCP Server](/zh-CN/integration/mcp-server)。
</Note>

<Badge color="yellow">即将上线</Badge>
 
<Badge color="blue" size="sm">每次调用 1 credit</Badge>

## 它为 Agent 做什么

`news_browse` 给 Agent 返回近期公司新闻，包含精炼标题、摘要和详细总结。你可以精确筛选市场动态、跟踪公司，或查找特定事件与主题组合。

可用范围会随公司和日期变化。先查近期新闻，再用精确筛选缩小结果范围。

## 返回值

<ResponseField name="data" type="object" required>
  匹配的新闻条目和返回数量。

  <Expandable title="data 字段">
    <ResponseField name="items" type="NewsArticle[]" required>
      先按 `published_at` 倒序，再按 `news_article_id` 倒序返回。

      <Expandable title="NewsArticle 字段">
        <ResponseField name="news_article_id" type="string" required>
          新闻条目的稳定标识。
        </ResponseField>

        <ResponseField name="title" type="string" required>
          便于快速浏览结果列表的短标题。
        </ResponseField>

        <ResponseField name="abstract" type="string" required>
          一到两句话，帮助 Agent 决定是否继续读完整总结。
        </ResponseField>

        <ResponseField name="summary" type="string" required>
          保留重要事实和限定信息的详细总结。
        </ResponseField>

        <ResponseField name="events" type="string[]" required>
          按字母排序的受控事件值。请忽略未来新增的未知值。
        </ResponseField>

        <ResponseField name="topics" type="string[]" required>
          按字母排序的受控主题值。请忽略未来新增的未知值。
        </ResponseField>

        <ResponseField name="tickers" type="string[]" required>
          与新闻相关的美股 symbol。
        </ResponseField>

        <ResponseField name="published_at" type="string" required>
          UTC 发布日期，精度到日。
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="count" type="number" required>
      本次响应返回的条目数量。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta.creditsUsed" type="number">合法查询执行后固定为 `1`，空结果也会扣。</ResponseField>
<ResponseField name="meta.remainingCredits" type="number">账户剩余 credit。</ResponseField>
<ResponseField name="meta.notice" type="string">无匹配数据或 `limit` 之外还有更多条目时返回。</ResponseField>

```json title="200 OK · news_browse" expandable theme={null}
{
  "data": {
    "items": [
      {
        "news_article_id": "2bb83823-9f85-40ed-a51a-34f67d41a6af",
        "title": "NVIDIA Announces Q1 Results",
        "abstract": "NVIDIA reported quarterly results and described demand across its major businesses.",
        "summary": "NVIDIA reported quarterly performance and provided updated guidance for the next period.",
        "events": ["earnings", "guidance"],
        "topics": ["artificial_intelligence", "semiconductors"],
        "tickers": ["NVDA"],
        "published_at": "2026-06-01"
      }
    ],
    "count": 1
  },
  "meta": { "creditsUsed": 1, "remainingCredits": 99 }
}
```

## 说明

<Tip>
  不传筛选条件可先看近期市场动态，再组合 `tickers`、`events` 和 `topics` 缩小范围。
</Tip>

<Warning>
  可用范围会随公司、日期和类别变化。所选筛选条件没有匹配内容时，合法查询可能返回空结果。
</Warning>

<Warning>
  每次合法查询消耗 1 credit，空结果也会扣。无效请求和服务错误不扣 credit。
</Warning>

## 直接调用

<Accordion title="HTTP / SDK 示例" icon="terminal">
  <CodeGroup>
    ```typescript MCP (Claude / Cursor) theme={null}
    {
      "method": "tools/call",
      "params": {
        "name": "news_browse",
        "arguments": {
          "tickers": ["NVDA"],
          "events": ["earnings", "guidance"],
          "limit": 5
        }
      }
    }
    ```

    ```python Python (HTTP) theme={null}
    import os, requests

    resp = requests.get(
        "https://api.llmquantdata.com/api/news/browse",
        headers={"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"},
        params={"tickers": "NVDA", "events": "earnings,guidance", "limit": 5},
    ).json()

    for item in resp["data"]["items"]:
        print(item["published_at"], item["title"])
    ```

    ```bash cURL theme={null}
    curl "https://api.llmquantdata.com/api/news/browse?tickers=NVDA&events=earnings,guidance&limit=5" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"
    ```
  </CodeGroup>
</Accordion>

## 完整参数参考

<Accordion title="news_browse — 请求参数" icon="sliders">
  <ParamField query="tickers" type="string">
    逗号分隔的美股 symbol，值之间按 OR 组合，最多 5 个。
  </ParamField>

  <ParamField query="events" type="string">
    逗号分隔的事件值，值之间按 OR 组合。支持：`earnings`、`guidance`、`m_and_a`、`partnership`、`product`、`regulatory_approval`、`regulatory`、`legal`、`leadership_change`、`workforce`、`restructuring`、`bankruptcy`、`capital_action`、`credit_rating`、`analyst_rating`、`accounting_audit`、`operational_incident`、`shareholder_meeting`、`strategic_update`、`other`。
  </ParamField>

  <ParamField query="topics" type="string">
    逗号分隔的主题值，值之间按 OR 组合。支持：`semiconductors`、`software`、`cloud_computing`、`cybersecurity`、`artificial_intelligence`、`consumer_electronics`、`it_hardware_networking`、`telecommunications`、`media_entertainment`、`internet_services`、`biotech_pharma`、`medical_devices`、`life_sciences_tools`、`healthcare_services`、`banking`、`capital_markets`、`insurance`、`fintech`、`crypto_digital_assets`、`real_estate`、`automotive`、`retail`、`consumer_packaged_goods`、`apparel_luxury`、`restaurants_leisure`、`aerospace_defense`、`industrial_machinery`、`transportation_logistics`、`construction_engineering`、`business_services`、`oil_gas`、`renewable_energy`、`utilities`、`metals_mining`、`chemicals`、`agriculture_food_production`、`paper_packaging_forestry`、`environmental_services`、`space_economy`、`quantum_computing`、`data_centers`、`macroeconomics_policy`、`geopolitics_trade`。
  </ParamField>

  <ParamField query="start_date" type="string">
    UTC 起始日期，`YYYY-MM-DD` 格式，包含当天，必须与 `end_date` 一起使用。
  </ParamField>

  <ParamField query="end_date" type="string">
    UTC 结束日期，`YYYY-MM-DD` 格式，包含当天，必须与 `start_date` 一起使用。
  </ParamField>

  <ParamField query="limit" type="number" default={10}>
    最多返回多少条，范围 1–25。
  </ParamField>
</Accordion>

不同参数之间按 AND 组合；`tickers`、`events`、`topics` 各自内部按 OR 组合。所有参数都可省略，此时返回近期市场动态。

## 相关接口

<Columns cols={2}>
  <Card title="认证" icon="key" href="/zh-CN/authentication">
    创建 API key，并用它认证 HTTP 请求。
  </Card>

  <Card title="MCP Server 配置" icon="plug" href="/zh-CN/integration/mcp-server">
    60 秒接入 Claude、Cursor 或其他 Agent harness。
  </Card>
</Columns>