Fund Real-time Estimation Scraper

The Need for Intraday Fund Valuation Estimation

At the end of a trading day, the official Net Asset Value (NAV) of a fund is announced. However, investors often want to know how their fund is performing during the market session. A common pain point is the lack of real-time NAV updates for open-ended funds, especially equity funds.

This skill offers a solution: it automatically scrapes the real-time prices of a fund's top holding stocks from the Tonghuashun iFund platform, and combined with publicly available portfolio weights, estimates the fund's NAV change for the day.

Core Capabilities and Working Principle

The skill is essentially a Playwright-based web scraper and data calculator. Its workflow is divided into two core parts:

1. Data Scraping (Playwright-driven)
* Target Website: fund.10jqka.com.cn
* Data Extracted: The list of the fund's top ten heavy-holding stocks displayed on the page, including each stock's intraday price change and its proportion in the fund's net assets.
* Technical Key: The target page content is dynamically rendered by JavaScript. The skill uses Playwright to drive a Chromium browser to load and access the complete DOM data.

2. Weighted Estimation Algorithm
After obtaining the holdings data, the skill performs a weighted calculation using a classic formula to derive the fund's NAV estimated change:
Σ(Stock's Daily Change % * Stock's Weight) / Σ(Stock's Weight)
This is equivalent to assuming the fund holds exactly these stocks with the proportions disclosed in its quarterly report. The result is a percentage representing the fund's estimated change relative to the previous trading day.

Supported features include:
* Single or Batch Queries: Use --code or --codes to query one or multiple funds.
* Output Formats: Results can be displayed as a terminal table (--format table) or saved to a JSON file (--format json).
* Debug Mode: Use --no-headless to show the browser window for observing page structure.

Applicable Scope and Important Caveats

It is crucial to understand its limitations and prerequisites before use. This is not a precise "real-time NAV" tool:

• Data Source Timeliness: The holdings data (stock codes and weights) is sourced from the fund's latest quarterly report, not its real-time portfolio. The fund manager may have adjusted holdings, so estimation deviations are inherent.
• Algorithm Coverage: It only considers the impact of the top ten holdings. Price changes of stocks outside the top ten are ignored, leading to a gap between the estimate and the actual NAV change.
• Trading Time Restrictions:
  • During non-trading hours (nights, holidays), the "daily change" of a stock might show the previous day's value or "no data."
  • The calculated estimate is most relevant during market trading sessions.
• Dependency on Target Platform: The skill's functionality is entirely dependent on the page structure of fund.10jqka.com.cn. Any website redesign may cause scraping failures.
• Query Frequency: Avoid making high-frequency, large-volume requests to prevent putting pressure on the target server or triggering anti-scraping mechanisms.

In summary, this tool is for aiding judgment on the intraday trend of a fund. Its output is an "estimate", not the precise NAV. Correct usage requires understanding its data sources and algorithmic assumptions.