datasinking 0.2.13__tar.gz → 0.2.14__tar.gz

{datasinking-0.2.13 → datasinking-0.2.14}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: datasinking
-Version: 0.2.13
-Summary: Python client for DataSinking — full-text Asian financial reports (China, Korea, Japan, Taiwan) as Markdown.
+Version: 0.2.14
+Summary: Python client for DataSinking — full-text financial reports (US, China, Japan, Korea, Taiwan) as Markdown.
 Author: DataSinking
 License: MIT
 Project-URL: Homepage, https://datasink.ing
 Project-URL: Documentation, https://datasink.ing/docs
 Project-URL: Repository, https://github.com/heubme2020/datasinking
-Keywords: a-share,china,korea,japan,financial reports,markdown,api,mcp,model-context-protocol,rag,llm
+Keywords: a-share,china,korea,japan,us,sec,financial reports,markdown,api,mcp,model-context-protocol,rag,llm
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -28,11 +28,11 @@ Dynamic: license-file
 [![PyPI version](https://img.shields.io/pypi/v/datasinking.svg)](https://pypi.org/project/datasinking/)
 [![MCP server](https://img.shields.io/badge/MCP-server-blue)](https://github.com/heubme2020/datasinking#mcp-server)
 
-**Full-text financial reports across Asia, as clean Markdown.**
+**Full-text financial reports across the US and Asia, as clean Markdown.**
 
 [DataSinking](https://datasink.ing) serves **full-text financial reports** — annual, semi-annual
-and quarterly — from **China, Korea, Japan and Taiwan** as clean **Markdown**, ready for LLM reading
-and RAG. Query by FMP-style symbol (`600519.SS`, `005930.KS`, `7203.T`, `2330.TW`) or filter by
+and quarterly — from **the US, China, Japan, Korea and Taiwan** as clean **Markdown**, ready for LLM reading
+and RAG. Query by FMP-style symbol (`AAPL`, `600519.SS`, `7203.T`, `005930.KS`, `2330.TW`) or filter by
 exchange, report period, or **section** — pull just the MD&A / risk section instead of the whole
 report. Reports are sourced from official disclosure platforms and parsed into structured Markdown
 with YAML frontmatter, preserved headings, paragraphs and tables.
@@ -144,6 +144,9 @@ errors that client actually produces:
 | Cursor | [`docs/mcp/cursor.md`](docs/mcp/cursor.md) |
 | DeepSeek Harness (`dsh`) | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
 | Devin Desktop | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.md) |
+| OpenCode | [`docs/mcp/opencode.md`](docs/mcp/opencode.md) |
+| Qoder | [`docs/mcp/qoder.md`](docs/mcp/qoder.md) |
+| Reasonix | [`docs/mcp/reasonix.md`](docs/mcp/reasonix.md) |
 
 ## Quick start
 
@@ -203,12 +206,12 @@ Start from [`research/TEMPLATE.md`](research/TEMPLATE.md).
 
 | | |
 |---|---|
-| Coverage | China (SSE / SZSE / BSE) · Korea (KOSPI / KOSDAQ / KONEX) · Japan (TSE) · Taiwan (TWSE / TPEx) |
+| Coverage | US (NYSE / NASDAQ / CBOE) · China (SSE / SZSE / BSE) · Japan (TSE) · Korea (KOSPI / KOSDAQ / KONEX) · Taiwan (TWSE / TPEx) |
 | Document types | annual / semiannual / q1 / q3 / amendment |
-| Update frequency | Daily — Korea/Japan via official DART/EDINET APIs (new filings within ~24h of publication) |
+| Update frequency | Daily — US/Korea/Japan via official SEC EDGAR / DART / EDINET APIs (new filings within ~24h of publication) |
 | Format | Full-text Markdown (with YAML frontmatter) |
 | API | REST — `GET /documents`, batch download, `with_content=1` for full text, `?section=` + `/sections` for chapter-level access |
-| Symbols | FMP style: `600519.SS` / `005930.KS` / `7203.T` |
+| Symbols | FMP style: `AAPL` / `600519.SS` / `7203.T` / `005930.KS` |
 | Auth | `?apikey=` query parameter (FMP style) |
 
 ## Data source
@@ -217,6 +220,7 @@ Reports are sourced from the official regulatory disclosure platform of each mar
 
 | Market | Source | Platform |
 |---|---|---|
+| US (bare ticker, e.g. `AAPL`) | SEC EDGAR | US Securities and Exchange Commission — sec.gov/edgar |
 | China A-shares (`.SS` `.SZ` `.BJ`) | 巨潮资讯网 cninfo | CSRC-designated disclosure platform |
 | Korea (`.KS` `.KQ` `.KN`) | DART | Financial Supervisory Service — opendart.fss.or.kr |
 | Japan (`.T`) | EDINET | Financial Services Agency — disclosure2.edinet-fsa.go.jp |

{datasinking-0.2.13 → datasinking-0.2.14}/README.md

@@ -5,11 +5,11 @@
 [![PyPI version](https://img.shields.io/pypi/v/datasinking.svg)](https://pypi.org/project/datasinking/)
 [![MCP server](https://img.shields.io/badge/MCP-server-blue)](https://github.com/heubme2020/datasinking#mcp-server)
 
-**Full-text financial reports across Asia, as clean Markdown.**
+**Full-text financial reports across the US and Asia, as clean Markdown.**
 
 [DataSinking](https://datasink.ing) serves **full-text financial reports** — annual, semi-annual
-and quarterly — from **China, Korea, Japan and Taiwan** as clean **Markdown**, ready for LLM reading
-and RAG. Query by FMP-style symbol (`600519.SS`, `005930.KS`, `7203.T`, `2330.TW`) or filter by
+and quarterly — from **the US, China, Japan, Korea and Taiwan** as clean **Markdown**, ready for LLM reading
+and RAG. Query by FMP-style symbol (`AAPL`, `600519.SS`, `7203.T`, `005930.KS`, `2330.TW`) or filter by
 exchange, report period, or **section** — pull just the MD&A / risk section instead of the whole
 report. Reports are sourced from official disclosure platforms and parsed into structured Markdown
 with YAML frontmatter, preserved headings, paragraphs and tables.
@@ -121,6 +121,9 @@ errors that client actually produces:
 | Cursor | [`docs/mcp/cursor.md`](docs/mcp/cursor.md) |
 | DeepSeek Harness (`dsh`) | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
 | Devin Desktop | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.md) |
+| OpenCode | [`docs/mcp/opencode.md`](docs/mcp/opencode.md) |
+| Qoder | [`docs/mcp/qoder.md`](docs/mcp/qoder.md) |
+| Reasonix | [`docs/mcp/reasonix.md`](docs/mcp/reasonix.md) |
 
 ## Quick start
 
@@ -180,12 +183,12 @@ Start from [`research/TEMPLATE.md`](research/TEMPLATE.md).
 
 | | |
 |---|---|
-| Coverage | China (SSE / SZSE / BSE) · Korea (KOSPI / KOSDAQ / KONEX) · Japan (TSE) · Taiwan (TWSE / TPEx) |
+| Coverage | US (NYSE / NASDAQ / CBOE) · China (SSE / SZSE / BSE) · Japan (TSE) · Korea (KOSPI / KOSDAQ / KONEX) · Taiwan (TWSE / TPEx) |
 | Document types | annual / semiannual / q1 / q3 / amendment |
-| Update frequency | Daily — Korea/Japan via official DART/EDINET APIs (new filings within ~24h of publication) |
+| Update frequency | Daily — US/Korea/Japan via official SEC EDGAR / DART / EDINET APIs (new filings within ~24h of publication) |
 | Format | Full-text Markdown (with YAML frontmatter) |
 | API | REST — `GET /documents`, batch download, `with_content=1` for full text, `?section=` + `/sections` for chapter-level access |
-| Symbols | FMP style: `600519.SS` / `005930.KS` / `7203.T` |
+| Symbols | FMP style: `AAPL` / `600519.SS` / `7203.T` / `005930.KS` |
 | Auth | `?apikey=` query parameter (FMP style) |
 
 ## Data source
@@ -194,6 +197,7 @@ Reports are sourced from the official regulatory disclosure platform of each mar
 
 | Market | Source | Platform |
 |---|---|---|
+| US (bare ticker, e.g. `AAPL`) | SEC EDGAR | US Securities and Exchange Commission — sec.gov/edgar |
 | China A-shares (`.SS` `.SZ` `.BJ`) | 巨潮资讯网 cninfo | CSRC-designated disclosure platform |
 | Korea (`.KS` `.KQ` `.KN`) | DART | Financial Supervisory Service — opendart.fss.or.kr |
 | Japan (`.T`) | EDINET | Financial Services Agency — disclosure2.edinet-fsa.go.jp |

{datasinking-0.2.13 → datasinking-0.2.14}/datasinking/_version.py

@@ -8,4 +8,4 @@ pyproject.toml 用 `dynamic = ["version"]` 从这里读，`client.py` 的 User-A
 写着旧版本）。现在只有这一处需要改。
 """
 
-__version__ = "0.2.13"
+__version__ = "0.2.14"

{datasinking-0.2.13 → datasinking-0.2.14}/datasinking/mcp_server.py

@@ -1,8 +1,8 @@
 # -*- coding: utf-8 -*-
 """DataSinking MCP server (Model Context Protocol).
 
-Expose the DataSinking API — full-text financial reports across Asia
-(China, Korea, Japan, Taiwan) as clean Markdown — to AI agents (Claude, Cursor,
+Expose the DataSinking API — full-text financial reports across the US and Asia
+(the US, China, Japan, Korea, Taiwan) as clean Markdown — to AI agents (Claude, Cursor,
 Codex, DeepSeek, Devin Desktop, …).
 
 Install the MCP extra::
@@ -62,14 +62,14 @@ API_KEY = os.environ.get("DATASINK_API_KEY", "")
 
 mcp = FastMCP(
     "DataSinking",
-    title="DataSinking — Full-text Asian Financial Reports",
-    description="Full-text Asian financial reports (China, Korea, Japan, Taiwan) as clean Markdown via API, with chapter-level access for RAG and AI agents.",
+    title="DataSinking — Full-text Financial Reports",
+    description="Full-text financial reports (US, China, Japan, Korea, Taiwan) as clean Markdown via API, with chapter-level access for RAG and AI agents.",
     version=__version__,
     instructions=(
         "DataSinking serves full-text financial reports (annual / semi-annual / quarterly) "
-        "from China, Korea, Japan and Taiwan as clean Markdown, ready for LLM reading and RAG. "
-        "Use FMP-style symbols: 600519.SS (Kweichow Moutai), 005930.KS (Samsung Electronics), "
-        "7203.T (Toyota), 2330.TW (TSMC). To save tokens, prefer get_section to pull one chapter "
+        "from the US, China, Japan, Korea and Taiwan as clean Markdown, ready for LLM reading and RAG. "
+        "Use FMP-style symbols: AAPL (Apple), 600519.SS (Kweichow Moutai), 7203.T (Toyota), "
+        "005930.KS (Samsung Electronics), 2330.TW (TSMC). To save tokens, prefer get_section to pull one chapter "
         "(e.g. MD&A) instead of get_report for the whole document."
     ),
 )
@@ -115,9 +115,9 @@ def _get(path: str, params: Optional[dict] = None) -> dict:
 def list_exchanges() -> list:
     """List the exchanges DataSinking covers.
 
-    Returns exchange codes (sse / szse / bj / ksc / koe / knx / jpx / twse / tpex) with
+    Returns exchange codes (nyse / nasdaq / cboe / sse / szse / bj / jpx / ksc / koe / knx / twse / tpex) with
     the number of reports available per exchange. Call this first to discover coverage.
-    Sources: A-shares = cninfo.com.cn, Korea = DART, Japan = EDINET, Taiwan = MOPS.
+    Sources: US = SEC EDGAR, A-shares = cninfo.com.cn, Japan = EDINET, Korea = DART, Taiwan = MOPS.
     """
     return _get("/exchanges").get("exchanges", [])
 
@@ -125,7 +125,7 @@ def list_exchanges() -> list:
 @mcp.tool()
 def list_stocks(
     exchange: Annotated[
-        str, Field(description="Exchange code, e.g. sse / szse / bj / ksc / koe / knx / jpx / twse / tpex")
+        str, Field(description="Exchange code, e.g. nyse / nasdaq / cboe / sse / szse / bj / jpx / ksc / koe / knx / twse / tpex")
     ],
     limit: Annotated[
         int, Field(description="Return only the first N companies (default 20) to keep the response short.")
@@ -139,7 +139,7 @@ def list_stocks(
 @mcp.tool()
 def list_reports(
     symbol: Annotated[
-        str, Field(description="FMP-style symbol, e.g. 600519.SS / 005930.KS / 7203.T / 2330.TW")
+        str, Field(description="FMP-style symbol, e.g. AAPL / 600519.SS / 7203.T / 005930.KS / 2330.TW")
     ],
     doc_type: Annotated[
         str, Field(description="Report type to filter on. Defaults to annual.")
@@ -190,12 +190,13 @@ def get_section(
         str,
         Field(
             description=(
-                "Heading keyword, matched as a substring against the report's OWN headings, "
-                "so pass it in the report's language. A-share reports have Chinese headings "
-                "(e.g. 第三节管理层讨论与分析) — use 管理层讨论与分析 / 财务报告 there. "
-                "For English-language filings, \"MD&A\" / \"financial statements\" / \"notes\" work. "
-                "If nothing matches, the API returns 404 with the real headings — retry with one "
-                "of those, or call list_sections first."
+                "Heading keyword. Matches the report's own headings, and also understands "
+                "cross-market concepts — MD&A / financial statements / notes / audit report / "
+                "risk / governance (or their Chinese/Japanese/Korean equivalents) resolve to the "
+                "right section in any market. Otherwise pass a heading in the report's language "
+                "(A-share: 管理层讨论与分析 / 财务报告; English filings: \"MD&A\" / "
+                "\"financial statements\" / \"notes\"). If nothing matches, the API returns 404 "
+                "with the real headings — retry with one of those, or call list_sections first."
             )
         ),
     ],

{datasinking-0.2.13 → datasinking-0.2.14}/datasinking.egg-info/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: datasinking
-Version: 0.2.13
-Summary: Python client for DataSinking — full-text Asian financial reports (China, Korea, Japan, Taiwan) as Markdown.
+Version: 0.2.14
+Summary: Python client for DataSinking — full-text financial reports (US, China, Japan, Korea, Taiwan) as Markdown.
 Author: DataSinking
 License: MIT
 Project-URL: Homepage, https://datasink.ing
 Project-URL: Documentation, https://datasink.ing/docs
 Project-URL: Repository, https://github.com/heubme2020/datasinking
-Keywords: a-share,china,korea,japan,financial reports,markdown,api,mcp,model-context-protocol,rag,llm
+Keywords: a-share,china,korea,japan,us,sec,financial reports,markdown,api,mcp,model-context-protocol,rag,llm
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -28,11 +28,11 @@ Dynamic: license-file
 [![PyPI version](https://img.shields.io/pypi/v/datasinking.svg)](https://pypi.org/project/datasinking/)
 [![MCP server](https://img.shields.io/badge/MCP-server-blue)](https://github.com/heubme2020/datasinking#mcp-server)
 
-**Full-text financial reports across Asia, as clean Markdown.**
+**Full-text financial reports across the US and Asia, as clean Markdown.**
 
 [DataSinking](https://datasink.ing) serves **full-text financial reports** — annual, semi-annual
-and quarterly — from **China, Korea, Japan and Taiwan** as clean **Markdown**, ready for LLM reading
-and RAG. Query by FMP-style symbol (`600519.SS`, `005930.KS`, `7203.T`, `2330.TW`) or filter by
+and quarterly — from **the US, China, Japan, Korea and Taiwan** as clean **Markdown**, ready for LLM reading
+and RAG. Query by FMP-style symbol (`AAPL`, `600519.SS`, `7203.T`, `005930.KS`, `2330.TW`) or filter by
 exchange, report period, or **section** — pull just the MD&A / risk section instead of the whole
 report. Reports are sourced from official disclosure platforms and parsed into structured Markdown
 with YAML frontmatter, preserved headings, paragraphs and tables.
@@ -144,6 +144,9 @@ errors that client actually produces:
 | Cursor | [`docs/mcp/cursor.md`](docs/mcp/cursor.md) |
 | DeepSeek Harness (`dsh`) | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
 | Devin Desktop | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.md) |
+| OpenCode | [`docs/mcp/opencode.md`](docs/mcp/opencode.md) |
+| Qoder | [`docs/mcp/qoder.md`](docs/mcp/qoder.md) |
+| Reasonix | [`docs/mcp/reasonix.md`](docs/mcp/reasonix.md) |
 
 ## Quick start
 
@@ -203,12 +206,12 @@ Start from [`research/TEMPLATE.md`](research/TEMPLATE.md).
 
 | | |
 |---|---|
-| Coverage | China (SSE / SZSE / BSE) · Korea (KOSPI / KOSDAQ / KONEX) · Japan (TSE) · Taiwan (TWSE / TPEx) |
+| Coverage | US (NYSE / NASDAQ / CBOE) · China (SSE / SZSE / BSE) · Japan (TSE) · Korea (KOSPI / KOSDAQ / KONEX) · Taiwan (TWSE / TPEx) |
 | Document types | annual / semiannual / q1 / q3 / amendment |
-| Update frequency | Daily — Korea/Japan via official DART/EDINET APIs (new filings within ~24h of publication) |
+| Update frequency | Daily — US/Korea/Japan via official SEC EDGAR / DART / EDINET APIs (new filings within ~24h of publication) |
 | Format | Full-text Markdown (with YAML frontmatter) |
 | API | REST — `GET /documents`, batch download, `with_content=1` for full text, `?section=` + `/sections` for chapter-level access |
-| Symbols | FMP style: `600519.SS` / `005930.KS` / `7203.T` |
+| Symbols | FMP style: `AAPL` / `600519.SS` / `7203.T` / `005930.KS` |
 | Auth | `?apikey=` query parameter (FMP style) |
 
 ## Data source
@@ -217,6 +220,7 @@ Reports are sourced from the official regulatory disclosure platform of each mar
 
 | Market | Source | Platform |
 |---|---|---|
+| US (bare ticker, e.g. `AAPL`) | SEC EDGAR | US Securities and Exchange Commission — sec.gov/edgar |
 | China A-shares (`.SS` `.SZ` `.BJ`) | 巨潮资讯网 cninfo | CSRC-designated disclosure platform |
 | Korea (`.KS` `.KQ` `.KN`) | DART | Financial Supervisory Service — opendart.fss.or.kr |
 | Japan (`.T`) | EDINET | Financial Services Agency — disclosure2.edinet-fsa.go.jp |

{datasinking-0.2.13 → datasinking-0.2.14}/pyproject.toml

@@ -7,12 +7,12 @@ name = "datasinking"
 # 版本号唯一来源 = datasinking/_version.py（client.py 的 User-Agent 也读它）。
 # 以前这里和包内 __version__ 各写各的，结果漂了半年（发 0.2.4 时才发现 __init__ 还停在 0.1.0）。
 dynamic = ["version"]
-description = "Python client for DataSinking — full-text Asian financial reports (China, Korea, Japan, Taiwan) as Markdown."
+description = "Python client for DataSinking — full-text financial reports (US, China, Japan, Korea, Taiwan) as Markdown."
 readme = "README.md"
 requires-python = ">=3.8"
 license = { text = "MIT" }
 authors = [{ name = "DataSinking" }]
-keywords = ["a-share", "china", "korea", "japan", "financial reports", "markdown", "api", "mcp", "model-context-protocol", "rag", "llm"]
+keywords = ["a-share", "china", "korea", "japan", "us", "sec", "financial reports", "markdown", "api", "mcp", "model-context-protocol", "rag", "llm"]
 classifiers = [
     "Programming Language :: Python :: 3",
     "License :: OSI Approved :: MIT License",