# China Dividend Value Screener MCP (`neeenja/china-dividend-value-screener`) Actor

A-share dividend + value screening over MCP. Filter China stocks by dividend yield, PE/PB, ROE and market cap; get one stock's payout history, consecutive dividend years and valuation. Free Eastmoney data, no API key. 4 tools, stdio + HTTP.

Love it? Support on Ko-fi https://ko-fi.com/panstories

- **URL**: https://apify.com/neeenja/china-dividend-value-screener.md
- **Developed by:** [Neeen Ja](https://apify.com/neeenja) (community)
- **Categories:** MCP servers, AI, Developer tools
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 mcp screen call — dividend / value screenings

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

<a id="english"></a>

## English · China Dividend Value Screener MCP

**Current version: 1.0.0**

**A-share dividend + value screening over MCP** — dividend yield, PE/PB, ROE and market-cap filters on free Eastmoney data. No API key, no upstream fees, no data vendor contract.

4 tools · remote Streamable HTTP · Proprietary

Languages: **English** · [简体中文](#简体中文) · [繁體中文](#繁體中文)

***

### Why this exists

Screening Chinese A-shares for a dividend-value strategy normally means either paying a data vendor or hand-scraping `data.eastmoney.com`. This server packages the Eastmoney data-centre reports behind four typed MCP tools, so an agent can answer questions like:

- *"Show me A-shares yielding over 6% with PE under 10 and ROE above 12%."*
- *"Has China Merchants Bank paid a dividend every year?"*
- *"What is ICBC trading at right now?"*

The upstream endpoint is public and free. The cost of running this server is the compute, not the data.

### Tools

| Tool | Billable | What it does |
|---|---|---|
| `screen_dividend_stocks` | $0.02 | Screen by **dividend yield floor + PE ceiling + PB ceiling + ROE floor + market-cap floor**. Joins the dividend-plan register with live valuation and the latest ROE. |
| `screen_value_stocks` | $0.02 | Classic value screen: low PE_TTM, low PB, positive operating cash flow, market-cap floor. |
| `get_dividend_profile` | $0.01 | One stock: recent payout plans (yield, pre-tax amount per 10 shares, ex-dividend date, implementation status), per-plan payout ratio, **consecutive dividend years**, current valuation and ROE. |
| `get_stock_valuation` | $0.01 | One stock: close, PE_TTM, PB_MRQ, PS_TTM, operating cash-flow ratio, market cap, latest ROE. |
| `describe_fields` | **free** | Field provenance: which upstream report and column each number comes from, whether it is reported or derived, its unit, and the known caveat. Never billed — provenance is not a paid feature. |

`initialize` and `tools/list` are always free — an agent must be able to connect and enumerate tools before spending anything.

#### Tool parameters

**`screen_dividend_stocks`**

| Param | Default | Meaning |
|---|---|---|
| `minDividendYieldPct` | `5` | Minimum dividend yield, in percent |
| `maxPE` | `15` | Maximum PE_TTM |
| `maxPB` | `3` | Maximum PB_MRQ |
| `minRoePct` | `null` | Minimum ROE, in percent (`null` = no ROE filter) |
| `minMktcapYi` | `30` | Minimum market cap in 億 CNY (100M CNY) |
| `annualOnly` | `false` | Keep only annual-report plans, drop interim dividends |
| `implementedOnly` | `false` | Keep only plans already implemented, drop proposals |
| `excludeST` | `true` | Drop ST / \*ST / delisting-risk names |
| `excludeBank` | `false` | Drop banks, insurers, brokers |
| `sinceYear` | last year | Earliest fiscal year of dividend plans |
| `yieldBasis` | `plan` | `plan` = the exchange's yield for one plan (v1.0 behaviour). `ttm` = **every implemented cash dividend with an ex-date in the trailing 12 months, ÷ current close** |
| `limit` | `20` | Max rows |

Under `yieldBasis: "ttm"` the headline `dividend_yield_pct` becomes the trailing aggregate, and each row also carries `ttm_dps`, `ttm_dividend_yield_pct` and `ttm_spans_fiscal_years`. Measured effect: 索菲亚 reads 7.16% on one plan and **10.68%** on TTM, because it pays twice a year.

**`screen_value_stocks`** — `maxPE` (10), `maxPB` (2), `minMktcapYi` (30), `requirePositivePCF` (true), `excludeST` (true), `excludeBank` (false), `limit` (20), `tradeDate` (optional).

**`get_stock_valuation`** — `code` (6-digit A-share code, e.g. `601398`).

**`get_dividend_profile`** — `code`, `years` (5).

### Data source

Three free, keyless Eastmoney reports, all served from the same public endpoint that powers `data.eastmoney.com`:

| Report | Used for |
|---|---|
| `RPT_VALUEANALYSIS_DET` | PE_TTM, PB_MRQ, PCF, PS_TTM, close price, total market cap |
| `RPT_SHAREBONUS_DET` | Dividend plans, `DIVIDENT_RATIO` (the exchange's own dividend yield), amount per 10 shares, ex-dividend date, implementation status |
| `RPT_LICO_FN_CPD` | Weighted-average ROE, EPS, BPS |

#### Data semantics you should know

- **Interim dividends are not annualised.** A plan filed against a `2026-06-30` period is a half-year yield. Use `annualOnly: true` when you want annual-report plans only. Every row carries a `report_period` label (`2025A`, `2026H1`, …) so the basis is never hidden.
- **ROE basis is labelled.** The server prefers the newest *annual* report and falls back to the newest interim one; each row reports `roe_basis` (`annual` / `interim`) and `roe_period`, because a half-year ROE must not be silently compared against a 10% annual hurdle.
- **Missing data stays missing.** Anything that cannot be sourced is returned as `null`, never defaulted to `0` — a fabricated 0% yield is worse than an absent one.
- **One trading day per screen.** `tradeDate` in the response tells you exactly which session the valuation snapshot is from.
- **`DIVIDENT_RATIO` is one plan, not the stock.** It is the exchange's own yield for a single distribution, measured against the price on that plan's announcement date — it ignores a second payment in the same year and uses a historical price. `get_dividend_profile` therefore also returns a TTM block (`ttm_dps`, `ttm_dividend_yield_pct`, `ttm_window`, `ttm_spans_fiscal_years`): the sum of implemented cash dividends with an ex-date in the trailing 12 months, divided by the current close. Pre-tax. Amounts are quoted **per 10 shares** and divided by 10.
- **Consecutive dividend years counts only money that was actually paid.** 预披露 and 董事会决议通过 have no ex-date and may never be paid, so they no longer extend the streak. When the streak runs to the edge of the retrieved history, `consecutive_years_is_lower_bound` is `true` and the number is a floor.

### Connect

#### Hosted on Apify (recommended)

```
https://<your-actor-run-id>.apify.actor/mcp
```

Send `Authorization: Bearer <APIFY_TOKEN>`. The endpoint speaks Streamable HTTP; POST JSON-RPC 2.0 messages (`initialize`, `tools/list`, `tools/call`).

#### Self-hosted deployment (on request)

The recommended way to use this server is the **hosted endpoint above** — zero setup, you call the tools and consume the screening results. The source code is **private** and **available on request**; self-hosted deployment of the server can be arranged by contacting PanStories. There is no public `npx` package and no public Git repository.

### Example response

```
A-share dividend + value screen · trading day 2026-09-30
Filters: yield ≥ 5% · PE_TTM ≤ 20 · PB ≤ 3 · ROE ≥ n/a% · market cap ≥ 50億 CNY
Scanned 60 dividend plans from 2025 onwards, showing 3.

 1. 601216 君正集团 (化学原料) yield 7.95% [2025A] · PE 12.5 · PB 1.39 · ROE 11.78% (2025-12-31) · mktcap 383.09億
 2. 600861 北京人力 (专业服务) yield 7.23% [2025A] · PE 9.47 · PB 1.02 · ROE 16.99% (2025-12-31) · mktcap 72.63億
 3. 002572 索菲亚 (家居用品) yield 7.16% [2025A] · PE 11.55 · PB 1.11 · ROE 12.27% (2025-12-31) · mktcap 74.35億
```

Every tool returns **both** a human-readable summary (`content`) and machine-readable data (`structuredContent`), so agents never have to parse prose.

### Pricing

| Event | Price | Tools |
|---|---|---|
| `mcp-screen` | $0.02 | `screen_dividend_stocks`, `screen_value_stocks` |
| `mcp-profile` | $0.01 | `get_dividend_profile`, `get_stock_valuation` |

Screens cost more because they fan out to three upstream reports; single-stock lookups take two. Discovery is free, and `describe_fields` is free on purpose. Set `maxTotalChargeUsd` on the run to cap autonomous agent spend.

Prices are unchanged by the v1.1.0 release: the new TTM fields ride on existing calls, and the new tool is deliberately not registered as a charge event.

### Limitations

- **A-shares only** (Shanghai / Shenzhen / Beijing). No HK, US or Taiwan listings — see the companion `mcp-stock-analyst` server for those.
- **No intraday data.** Valuation snapshots are end-of-day.
- **Not investment advice.** This server screens public data. It does not know your position, your horizon or your tax situation.

### Source & licence

Proprietary © PanStories. Source is available on request; the repository remains private. This server is offered as a **hosted service** (pay-per-event on Apify) — you consume the screening results, not the code.

**Privacy** — read-only and stateless; no accounts, no cookies, no trackers, no personal data collected. See the [Privacy Policy](#privacy-policy) below.

***

<a id="简体中文"></a>

### 简体中文

**当前版本：1.0.0**

#### 这是什么

**A 股高股息 + 价值筛选 MCP 服务**。用免费东方财富数据做股息率、PE/PB、ROE、市值门槛筛选，**无需 API key，零上游数据成本**。

#### 五个工具

| 工具 | 计费 | 作用 |
|---|---|---|
| `screen_dividend_stocks` | $0.02 | 按**股息率下限 + PE 上限 + PB 上限 + ROE 下限 + 市值下限**筛选；把分红方案台账与实时估值、最新 ROE 三张表做联结。可选 `yieldBasis="ttm"` 改用**滚动 12 个月真实派息合计**口径 |
| `screen_value_stocks` | $0.02 | 经典价值筛选：低 PE_TTM、低 PB、经营现金流为正、市值门槛 |
| `get_dividend_profile` | $0.01 | 单只股票：历次分红方案（股息率、每 10 股税前派息、除权日、实施进度）、单次派息率、**连续分红年数**、**TTM 真实股息率**、当前估值与 ROE |
| `get_stock_valuation` | $0.01 | 单只股票：收盘价、PE_TTM、PB_MRQ、PS_TTM、现金流市销比、市值、最新 ROE |
| `describe_fields` | **免费** | 字段溯源：每个数字来自哪张报表哪一列、是实测值还是推导值、单位、以及已知口径坑。永不计费 |

`initialize` 与 `tools/list` 永久免费 —— 智能体必须先能连上并列出工具，才谈得上消费。

#### 必须知道的数据口径

- **中期分红不做年化。** 归属 `2026-06-30` 的方案就是半年口径的股息率。只要年报刊方案，把 `annualOnly` 设为 `true`。每行都带 `report_period` 标签（`2025A`／`2026H1`…），口径从不含糊。
- **ROE 口径明示。** 优先取最新**年报** ROE，取不到才退回最新中报；每行都给出 `roe_basis`（`annual`／`interim`）与 `roe_period` —— 半年 ROE 不能悄悄拿去和「年化 10%」的门槛比。
- **取不到就是 `null`。** 任何无法取到的数字一律返回 `null`，绝不默认为 `0`。编出来的 0% 股息率比缺失更害人。
- **每次筛选只对应一个交易日。** 响应里的 `tradeDate` 明确告诉你估值快照取自哪一天。
- **`DIVIDENT_RATIO` 是「单笔方案」不是「这只股票」。** 它是交易所按**该方案公告日的股价**算的单次股息率：同年第二次派息不算，用的还是旧股价。因此 `get_dividend_profile` 额外返回 TTM 区块（`ttm_dps`、`ttm_dividend_yield_pct`、`ttm_window`、`ttm_spans_fiscal_years`）——滚动 12 个月内**已实施**现金分红合计 ÷ 当前收盘价（税前；派息额按**每 10 股**计，需 ÷10）。实测差异：索菲亚单笔口径 7.16%，TTM 口径 **10.68%**（一年两派）。
- **连续分红年数只算真的发了钱的分红。** `预披露`、`董事会决议通过` 没有除权日、也可能最终不发，不再延长连续年数；若连续年数一直顶到已取历史的边界，`consecutive_years_is_lower_bound` 为 `true`，该数字是**下界**。

#### 接入

- **Apify 托管（推荐）**：`https://<run-id>.apify.actor/mcp`，带 `Authorization: Bearer <APIFY_TOKEN>`，Streamable HTTP 协议，POST JSON-RPC 2.0。
- **自托管部署（按需提供）**：推荐用上面的托管端点，零配置、直接消费筛选结果。源码为私有、可按需提供；自托管部署请联系 PanStories。无公开 `npx` 包、无公开 Git 仓库。

#### 计费

筛选类工具（`screen_*`）$0.02／次，单只查询（`get_*`）$0.01／次。筛选贵一倍是因为它要扇出到三张上游报表，单只查询只用两张。`describe_fields` 永久免费。

v1.1.0 **不涨价**：新增的 TTM 字段挂在既有调用上，新工具刻意不注册计费事件。

#### 限制

- **仅 A 股**（沪／深／京）。港股、美股、台股请用配套的 `mcp-stock-analyst`。
- **无盘中数据**，估值快照为收盘口径。
- **不构成投资建议**。本服务只做公开数据的筛选，不知道你的持仓、期限与税负。

#### 源码与许可

专有（Proprietary）© PanStories。源码可按需提供；仓库保持私有。本服务以**托管形式**提供（Apify 按事件计费）—— 你消费的是筛选结果，不是代码。

**隐私 / Privacy** — 只读、无状态；无账号、无 Cookie、无追踪，不收集任何个人信息。详见下文 [隐私政策](#privacy-policy)。

***

<a id="繁體中文"></a>

### 繁體中文

**當前版本：1.0.0**

#### 這是什麼

**A 股高股息 + 價值篩選 MCP 服務**。以免費東方財富資料做股息率、PE/PB、ROE、市值門檻篩選，**無需 API key、零上游資料成本**。

#### 五個工具

| 工具 | 計費 | 作用 |
|---|---|---|
| `screen_dividend_stocks` | $0.02 | 依**股息率下限 + PE 上限 + PB 上限 + ROE 下限 + 市值下限**篩選；將分紅方案台帳與即時估值、最新 ROE 三張表做聯結。可選 `yieldBasis="ttm"` 改用**滾動 12 個月實際派息合計**口徑 |
| `screen_value_stocks` | $0.02 | 經典價值篩選：低 PE_TTM、低 PB、營業現金流為正、市值門檻 |
| `get_dividend_profile` | $0.01 | 單一個股：歷次分紅方案（股息率、每 10 股稅前派息、除權日、實施進度）、單次派息率、**連續分紅年數**、**TTM 真實股息率**、當前估值與 ROE |
| `get_stock_valuation` | $0.01 | 單一個股：收盤價、PE_TTM、PB_MRQ、PS_TTM、現金流市銷比、市值、最新 ROE |
| `describe_fields` | **免費** | 欄位溯源：每個數字來自哪張報表哪一欄、是實測值還是推導值、單位，以及已知口徑陷阱。永不計費 |

`initialize` 與 `tools/list` 永久免費 —— 智慧體必須先能連上並列出工具，才談得上消費。

#### 必須知道的資料口徑

- **期中分紅不做年化。** 歸屬 `2026-06-30` 的方案就是半年口徑的股息率。只要年報方案，請把 `annualOnly` 設為 `true`。每一列都帶 `report_period` 標籤（`2025A`／`2026H1`…），口徑從不含糊。
- **ROE 口徑明示。** 優先取最新**年報** ROE，取不到才退回最新期中報；每一列都給出 `roe_basis`（`annual`／`interim`）與 `roe_period` —— 半年 ROE 不該悄悄拿去和「年化 10%」的門檻相比。
- **取不到就是 `null`。** 任何無法取得的數字一律回傳 `null`，絕不預設為 `0`。捏造出來的 0% 股息率比缺漏更糟。
- **每次篩選只對應一個交易日。** 回應中的 `tradeDate` 明確指出估值快照取自哪一天。
- **`DIVIDENT_RATIO` 是「單一方案」而非「這檔股票」。** 它是交易所依**該方案公告日股價**算出的單次股息率：同一年的第二次派息不計入，用的還是舊股價。因此 `get_dividend_profile` 額外回傳 TTM 區塊（`ttm_dps`、`ttm_dividend_yield_pct`、`ttm_window`、`ttm_spans_fiscal_years`）——滾動 12 個月內**已實施**現金分紅合計 ÷ 當前收盤價（稅前；派息額為**每 10 股**，需 ÷10）。實測差異：索菲亞單一方案口徑 7.16%，TTM 口徑 **10.68%**（一年兩次派息）。
- **連續分紅年數只算真正發出去的錢。** `預披露`、`董事會決議通過` 沒有除權日、也可能最終不發，不再延長連續年數；若連續年數頂到已取歷史的邊界，`consecutive_years_is_lower_bound` 為 `true`，該數字是**下界**。

#### 接入

- **Apify 託管（推薦）**：`https://<run-id>.apify.actor/mcp`，帶 `Authorization: Bearer <APIFY_TOKEN>`，Streamable HTTP 協定，POST JSON-RPC 2.0。
- **自託管部署（按需提供）**：推薦用上面的託管端點，零配置、直接消費篩選結果。原始碼為私有、可依需求提供；自託管部署請聯絡 PanStories。無公開 `npx` 套件、無公開 Git 倉庫。

#### 計費

篩選類工具（`screen_*`）$0.02／次，單一個股查詢（`get_*`）$0.01／次。篩選貴一倍是因為它要扇出到三張上游報表，單一個股查詢只用兩張。`describe_fields` 永久免費。

v1.1.0 **不漲價**：新增的 TTM 欄位掛在既有呼叫上，新工具刻意不註冊計費事件。

#### 限制

- **僅 A 股**（滬／深／京）。港股、美股、台股請用配套的 `mcp-stock-analyst`。
- **無盤中資料**，估值快照為收盤口徑。
- **不構成投資建議**。本服務僅就公開資料做篩選，不知道你的持倉、期限與稅負。

#### 原始碼與授權

專有（Proprietary）© PanStories。原始碼可依需求提供；倉庫保持私有。本服務以**託管形式**提供（Apify 按事件計費）—— 你消費的是篩選結果，不是程式碼。

**隱私 / Privacy** — 唯讀、無狀態；無帳號、無 Cookie、無追蹤，不收集任何個人資訊。詳見下文 [隱私政策](#privacy-policy)。

***

<a id="privacy-policy"></a>

### Privacy Policy

**Product:** China Dividend Value Screener MCP (MCP server)
**Operator:** PanStories
**Last updated:** 2026-10-09
**Effective date:** 2026-10-09

This is the authoritative privacy policy for this hosted service. It is reproduced in
full here because the source repository is private; the identical text also ships as
`PRIVACY.md` in the repository.

#### 1. Summary (TL;DR)

- The Service is a **read-only** MCP server. Its tools only *read* public A-share market
  data on free Eastmoney endpoints to screen for dividend/value metrics. They never
  modify, delete, or act on your systems.
- **No accounts, no sign-up, no cookies, no advertising or analytics trackers.**
- We do **not** sell, rent, or share your data with advertisers or data brokers.
- The only inputs are **public A-share stock codes and screening filters** (dividend
  yield, PE/PB, ROE, market cap). No personal data is required or requested.
- The server is **stateless**: each request is independent, with no session and no user
  profile.
- Hosting is provided by **Apify**; platform-level processing is governed by Apify's own
  privacy policy.

#### 2. Data we process

| Data | Source | Why we process it | Retention |
|---|---|---|---|
| Stock codes / screener parameters | You | To screen A-shares by dividend/value metrics | In memory for the duration of the request only |
| Numeric filters (yield, PE/PB, ROE, cap, years) | You | To bound the screening query | Request duration only |
| IP address + User-Agent | Your request | Transient rate-limiting only | In-memory window; not persisted, not logged to disk |
| Apify API token | Apify gateway | Authenticates the caller at the platform edge | Not seen or stored by the Service |

#### 3. What we do NOT collect

- No names, email addresses, phone numbers, or other personal identifiers.
- No trading accounts, brokerage credentials, positions, or portfolio data.
- No accounts, passwords, or credentials.
- No conversation history or tool-call content retained beyond the live request.
- No cookies, analytics, pixels, or advertising trackers.

#### 4. Third parties / data recipients

To answer a query the Service fetches **public market data** from Eastmoney. Your
screener parameters are forwarded to them; no personal data is included.

| Recipient | Purpose | Notes |
|---|---|---|
| **Eastmoney** (`data.eastmoney.com`, `datacenter-web.eastmoney.com`) | Public A-share fundamentals and dividend data | Public market endpoints |
| **Apify** (hosting) | Runs the Standby container and meters usage | Subject to Apify's privacy policy |

We do not disclose your inputs to any other third party.

#### 5. Hosting and infrastructure

The hosted Service runs on Apify's Standby infrastructure. Apify may process operational
metadata (timestamps, IP, billing records) as an independent controller. See
<https://apify.com/privacy-policy>. The Service runs no database and keeps no persistent
store of user data.

#### 6. Self-hosted builds

The source is not publicly distributed. Where a self-hosted build exists, its operator is
the data controller for anything that deployment processes.

#### 7. Security

Transport is encrypted (TLS) at the Apify edge. All requests require the Apify gateway
bearer token. See the repository's `SECURITY.md` for the threat model and vulnerability
reporting.

#### 8. Children's privacy

The Service is a developer tool not directed at children, and we do not knowingly process
data from children under 16.

#### 9. Your rights

Because we do not maintain user profiles or store personal data, there is generally no
personal data to access, correct, or erase. If you believe we hold data about you, contact
us (Section 11) and we will respond within 30 days.

#### 10. Changes to this policy

We may update this policy as the Service evolves. Material changes will be reflected in the
"Last updated" date and, where appropriate, in this README.

#### 11. Contact

Privacy questions or requests: contact the operator via this Apify Store listing
(**Issues** tab), or open an issue in the repository if you have access.

#### 隐私政策（简体中文）

**产品：** China Dividend Value Screener MCP — A 股股息/价值筛选 MCP server
**运营方：** PanStories
**最后更新：** 2026-10-09

##### 概要

- 本服务是**只读** MCP server，工具仅*读取*东方财富免费接口的公开 A 股行情数据，
  用于按股息/价值指标选股，不会修改、删除或操作用户的任何系统。
- **无账号、无注册、无 Cookie、无广告或分析追踪。**
- 我们**不会**向广告商或数据经纪商出售、出租或共享你的数据。
- 唯一输入为**公开 A 股代码与筛选条件**（股息率、PE/PB、ROE、市值），不涉及个人信息。
- 服务**无状态**：每次请求独立处理，无会话、无用户画像。
- 托管由 **Apify** 提供，平台层处理受 Apify 隐私政策约束。

##### 我们处理的数据

| 数据 | 来源 | 用途 | 保留 |
|---|---|---|---|
| 股票代码 / 筛选参数 | 调用方 | 按股息/价值指标筛选 A 股 | 仅请求期间驻留内存 |
| 数值筛选（股息率、PE/PB、ROE、市值、年限） | 调用方 | 限定筛选查询 | 仅请求期间 |
| IP + User-Agent | 请求 | 仅用于限流 | 内存窗口，不落盘 |
| Apify API token | Apify 网关 | 在平台边缘鉴权 | 本服务不接触、不存储 |

##### 第三方（仅转发公开数据，不含个人信息）

- **东方财富**（`data.eastmoney.com` / `datacenter-web.eastmoney.com`）：公开 A 股基本面与分红数据。
- **Apify**（托管）：运行 Standby 容器并计量。参见 <https://apify.com/privacy-policy>。

##### 联系方式

通过本 Apify Store 详情页（**Issues** 标签）联系运营者；如有仓库权限，亦可在仓库提 issue。

# Actor input Schema

## `maxTotalChargeUsd` (type: `number`):

Hard cap on how much this run may charge. Recommended when letting an autonomous agent call the server. Example: 0.20 USD = 10 screen calls.

## Actor input object example

```json
{}
```

# Actor output Schema

## `mcpEndpoint` (type: `string`):

Streamable HTTP MCP endpoint of this Actor run. Connect an MCP client here (Authorization: Bearer \<APIFY_TOKEN>). POST JSON-RPC messages: initialize, tools/list, tools/call.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("neeenja/china-dividend-value-screener").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("neeenja/china-dividend-value-screener").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call neeenja/china-dividend-value-screener --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neeenja/china-dividend-value-screener"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/yUWYT4rqE6KEvAb3q/builds/m2megGEf6Xht626CN/openapi.json