PyPI - datasinking - Versions diffs - 0.2.12__tar.gz → 0.2.14__tar.gz - Mend

datasinking 0.2.12tar.gz → 0.2.14tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

{datasinking-0.2.12 → datasinking-0.2.14}/PKG-INFO RENAMED Viewed

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: datasinking
-Version: 0.2.12
-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.
@@ -41,20 +41,21 @@ with YAML frontmatter, preserved headings, paragraphs and tables.
 ## MCP server
-Ship DataSinking to any AI agent (Claude / Cursor / Codex / Windsurf) as an
+Ship DataSinking to any AI agent (Claude / Cursor / Codex / Devin Desktop) as an
 [MCP](https://modelcontextprotocol.io) server — 6 tools: list exchanges, list stocks,
 list reports, fetch a report, list sections, fetch one section (token-friendly for RAG).
 ### Hosted — nothing to install
-Point any MCP client at our endpoint and you're done. No package, no Python, no local server:
+One URL, no package, no Python, no local server. Most clients take this shape:
 ```json
 {
   "mcpServers": {
     "datasinking": {
       "type": "http",
-      "url": "https://api.datasink.ing/mcp?apikey=YOUR_KEY"
+      "url": "https://api.datasink.ing/mcp",
+      "headers": { "Authorization": "Bearer YOUR_KEY" }
     }
   }
 }
@@ -67,9 +68,12 @@ claude mcp add --transport http datasinking https://api.datasink.ing/mcp \
   --header "Authorization: Bearer YOUR_KEY"
 ```
-Your key rides inside the URL, so treat that config as a secret. Clients that support custom
-headers can send `Authorization: Bearer YOUR_KEY` instead — Claude Code redacts headers in its
-output but can't redact a URL.
+A client that can't set a header can put the key in the URL instead —
+`https://api.datasink.ing/mcp?apikey=YOUR_KEY` — but only do that when you must: a key in a URL
+ends up in logs and screen shares, and no client can redact it.
+Two clients don't fit the shape above: Codex's config is TOML, and Devin Desktop's remote field is
+`serverUrl`, not `url`. Per-client files: [`docs/mcp/`](docs/mcp/).
 ### Local — run it yourself
@@ -104,8 +108,9 @@ kept in lockstep by [`check_mcp_parity.py`](check_mcp_parity.py).
 Full per-client setup: [`mcp-server.md`](mcp-server.md) (overview) ·
 [`docs/mcp/`](docs/mcp/) (one guide per client).
-Hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, no session id, and every
-client needs a restart after a config change. That trips up most first connections.
+The hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, and no session id is
+issued. Most clients read MCP config at launch, so restart one after changing its config.
 ![DataSinking MCP in Claude](docs/images/mcp-demo.png)
@@ -119,8 +124,8 @@ datasinking/
 ├── research/     # Research notes / blog posts (reproducing paper-style presentation)
 ├── datasinking/  # Python client + MCP server — pip install "datasinking[mcp]"
 ├── npm/          # The same MCP server on npm — npx -y datasinking-mcp (Node 18+)
-├── docs/mcp/     # Per-client MCP setup: Claude Code, Claude Desktop, Cursor, Codex, WorkBuddy
-├── mcp-server.md # MCP server overview — the two config shapes, tools, endpoint limits
+├── docs/mcp/     # Per-client MCP setup — Claude Code, Desktop, Cursor, Codex, WorkBuddy, Devin…
+├── mcp-server.md # MCP server overview — endpoint, per-client table, tools, troubleshooting
 ├── llm-examples.md  # Ask an LLM — no code needed (8 end-to-end examples)
 ├── api-examples.md  # 7 examples × 3 interfaces (curl / Python / LLM)
 └── README.md
@@ -135,9 +140,13 @@ errors that client actually produces:
 | Claude Desktop | [`docs/mcp/claude-desktop.md`](docs/mcp/claude-desktop.md) |
 | OpenAI Codex CLI | [`docs/mcp/codex.md`](docs/mcp/codex.md) |
 | WorkBuddy / CodeBuddy | [`docs/mcp/workbuddy.md`](docs/mcp/workbuddy.md) |
+| Doubao Work / 豆包工作 | [`docs/mcp/doubao.md`](docs/mcp/doubao.md) |
 | Cursor | [`docs/mcp/cursor.md`](docs/mcp/cursor.md) |
-| DeepSeek | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
-| Windsurf | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.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
@@ -197,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
@@ -211,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.12 → datasinking-0.2.14}/README.md RENAMED Viewed

@@ -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.
@@ -18,20 +18,21 @@ with YAML frontmatter, preserved headings, paragraphs and tables.
 ## MCP server
-Ship DataSinking to any AI agent (Claude / Cursor / Codex / Windsurf) as an
+Ship DataSinking to any AI agent (Claude / Cursor / Codex / Devin Desktop) as an
 [MCP](https://modelcontextprotocol.io) server — 6 tools: list exchanges, list stocks,
 list reports, fetch a report, list sections, fetch one section (token-friendly for RAG).
 ### Hosted — nothing to install
-Point any MCP client at our endpoint and you're done. No package, no Python, no local server:
+One URL, no package, no Python, no local server. Most clients take this shape:
 ```json
 {
   "mcpServers": {
     "datasinking": {
       "type": "http",
-      "url": "https://api.datasink.ing/mcp?apikey=YOUR_KEY"
+      "url": "https://api.datasink.ing/mcp",
+      "headers": { "Authorization": "Bearer YOUR_KEY" }
     }
   }
 }
@@ -44,9 +45,12 @@ claude mcp add --transport http datasinking https://api.datasink.ing/mcp \
   --header "Authorization: Bearer YOUR_KEY"
 ```
-Your key rides inside the URL, so treat that config as a secret. Clients that support custom
-headers can send `Authorization: Bearer YOUR_KEY` instead — Claude Code redacts headers in its
-output but can't redact a URL.
+A client that can't set a header can put the key in the URL instead —
+`https://api.datasink.ing/mcp?apikey=YOUR_KEY` — but only do that when you must: a key in a URL
+ends up in logs and screen shares, and no client can redact it.
+Two clients don't fit the shape above: Codex's config is TOML, and Devin Desktop's remote field is
+`serverUrl`, not `url`. Per-client files: [`docs/mcp/`](docs/mcp/).
 ### Local — run it yourself
@@ -81,8 +85,9 @@ kept in lockstep by [`check_mcp_parity.py`](check_mcp_parity.py).
 Full per-client setup: [`mcp-server.md`](mcp-server.md) (overview) ·
 [`docs/mcp/`](docs/mcp/) (one guide per client).
-Hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, no session id, and every
-client needs a restart after a config change. That trips up most first connections.
+The hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, and no session id is
+issued. Most clients read MCP config at launch, so restart one after changing its config.
 ![DataSinking MCP in Claude](docs/images/mcp-demo.png)
@@ -96,8 +101,8 @@ datasinking/
 ├── research/     # Research notes / blog posts (reproducing paper-style presentation)
 ├── datasinking/  # Python client + MCP server — pip install "datasinking[mcp]"
 ├── npm/          # The same MCP server on npm — npx -y datasinking-mcp (Node 18+)
-├── docs/mcp/     # Per-client MCP setup: Claude Code, Claude Desktop, Cursor, Codex, WorkBuddy
-├── mcp-server.md # MCP server overview — the two config shapes, tools, endpoint limits
+├── docs/mcp/     # Per-client MCP setup — Claude Code, Desktop, Cursor, Codex, WorkBuddy, Devin…
+├── mcp-server.md # MCP server overview — endpoint, per-client table, tools, troubleshooting
 ├── llm-examples.md  # Ask an LLM — no code needed (8 end-to-end examples)
 ├── api-examples.md  # 7 examples × 3 interfaces (curl / Python / LLM)
 └── README.md
@@ -112,9 +117,13 @@ errors that client actually produces:
 | Claude Desktop | [`docs/mcp/claude-desktop.md`](docs/mcp/claude-desktop.md) |
 | OpenAI Codex CLI | [`docs/mcp/codex.md`](docs/mcp/codex.md) |
 | WorkBuddy / CodeBuddy | [`docs/mcp/workbuddy.md`](docs/mcp/workbuddy.md) |
+| Doubao Work / 豆包工作 | [`docs/mcp/doubao.md`](docs/mcp/doubao.md) |
 | Cursor | [`docs/mcp/cursor.md`](docs/mcp/cursor.md) |
-| DeepSeek | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
-| Windsurf | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.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
@@ -174,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
@@ -188,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.12 → datasinking-0.2.14}/datasinking/_version.py RENAMED Viewed

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

{datasinking-0.2.12 → datasinking-0.2.14}/datasinking/mcp_server.py RENAMED Viewed

@@ -1,9 +1,9 @@
 # -*- 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,
-Codex, DeepSeek, Windsurf, …).
+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.12 → datasinking-0.2.14}/datasinking.egg-info/PKG-INFO RENAMED Viewed

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: datasinking
-Version: 0.2.12
-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.
@@ -41,20 +41,21 @@ with YAML frontmatter, preserved headings, paragraphs and tables.
 ## MCP server
-Ship DataSinking to any AI agent (Claude / Cursor / Codex / Windsurf) as an
+Ship DataSinking to any AI agent (Claude / Cursor / Codex / Devin Desktop) as an
 [MCP](https://modelcontextprotocol.io) server — 6 tools: list exchanges, list stocks,
 list reports, fetch a report, list sections, fetch one section (token-friendly for RAG).
 ### Hosted — nothing to install
-Point any MCP client at our endpoint and you're done. No package, no Python, no local server:
+One URL, no package, no Python, no local server. Most clients take this shape:
 ```json
 {
   "mcpServers": {
     "datasinking": {
       "type": "http",
-      "url": "https://api.datasink.ing/mcp?apikey=YOUR_KEY"
+      "url": "https://api.datasink.ing/mcp",
+      "headers": { "Authorization": "Bearer YOUR_KEY" }
     }
   }
 }
@@ -67,9 +68,12 @@ claude mcp add --transport http datasinking https://api.datasink.ing/mcp \
   --header "Authorization: Bearer YOUR_KEY"
 ```
-Your key rides inside the URL, so treat that config as a secret. Clients that support custom
-headers can send `Authorization: Bearer YOUR_KEY` instead — Claude Code redacts headers in its
-output but can't redact a URL.
+A client that can't set a header can put the key in the URL instead —
+`https://api.datasink.ing/mcp?apikey=YOUR_KEY` — but only do that when you must: a key in a URL
+ends up in logs and screen shares, and no client can redact it.
+Two clients don't fit the shape above: Codex's config is TOML, and Devin Desktop's remote field is
+`serverUrl`, not `url`. Per-client files: [`docs/mcp/`](docs/mcp/).
 ### Local — run it yourself
@@ -104,8 +108,9 @@ kept in lockstep by [`check_mcp_parity.py`](check_mcp_parity.py).
 Full per-client setup: [`mcp-server.md`](mcp-server.md) (overview) ·
 [`docs/mcp/`](docs/mcp/) (one guide per client).
-Hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, no session id, and every
-client needs a restart after a config change. That trips up most first connections.
+The hosted endpoint is **POST-only and stateless** — `GET /mcp` returns 405, and no session id is
+issued. Most clients read MCP config at launch, so restart one after changing its config.
 ![DataSinking MCP in Claude](docs/images/mcp-demo.png)
@@ -119,8 +124,8 @@ datasinking/
 ├── research/     # Research notes / blog posts (reproducing paper-style presentation)
 ├── datasinking/  # Python client + MCP server — pip install "datasinking[mcp]"
 ├── npm/          # The same MCP server on npm — npx -y datasinking-mcp (Node 18+)
-├── docs/mcp/     # Per-client MCP setup: Claude Code, Claude Desktop, Cursor, Codex, WorkBuddy
-├── mcp-server.md # MCP server overview — the two config shapes, tools, endpoint limits
+├── docs/mcp/     # Per-client MCP setup — Claude Code, Desktop, Cursor, Codex, WorkBuddy, Devin…
+├── mcp-server.md # MCP server overview — endpoint, per-client table, tools, troubleshooting
 ├── llm-examples.md  # Ask an LLM — no code needed (8 end-to-end examples)
 ├── api-examples.md  # 7 examples × 3 interfaces (curl / Python / LLM)
 └── README.md
@@ -135,9 +140,13 @@ errors that client actually produces:
 | Claude Desktop | [`docs/mcp/claude-desktop.md`](docs/mcp/claude-desktop.md) |
 | OpenAI Codex CLI | [`docs/mcp/codex.md`](docs/mcp/codex.md) |
 | WorkBuddy / CodeBuddy | [`docs/mcp/workbuddy.md`](docs/mcp/workbuddy.md) |
+| Doubao Work / 豆包工作 | [`docs/mcp/doubao.md`](docs/mcp/doubao.md) |
 | Cursor | [`docs/mcp/cursor.md`](docs/mcp/cursor.md) |
-| DeepSeek | [`docs/mcp/deepseek.md`](docs/mcp/deepseek.md) |
-| Windsurf | [`docs/mcp/windsurf.md`](docs/mcp/windsurf.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
@@ -197,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
@@ -211,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.12 → datasinking-0.2.14}/pyproject.toml RENAMED Viewed

@@ -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",