datasinking 0.2.8__tar.gz → 0.2.9__tar.gz

{datasinking-0.2.8 → datasinking-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datasinking
-Version: 0.2.8
+Version: 0.2.9
 Summary: Python client for DataSinking — full-text Asian financial reports (China, Korea, Japan, Taiwan) as Markdown.
 Author: DataSinking
 License: MIT
@@ -31,27 +31,58 @@ Dynamic: license-file
 **Full-text financial reports across Asia, as clean Markdown.**
 
 [DataSinking](https://datasink.ing) serves **full-text financial reports** — annual, semi-annual
-and quarterly — from **China, Korea and Japan** as clean **Markdown**, ready for LLM reading
-and RAG. Query by FMP-style symbol (`600519.SS`, `005930.KS`, `7203.T`) 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.
+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
+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.
 
 ---
 
 ## MCP server
 
-Ship DataSinking to any AI agent (Claude Desktop / Cursor / Codex / Windsurf) as an
+Ship DataSinking to any AI agent (Claude / Cursor / Codex / Windsurf) 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:
+
+```json
+{
+  "mcpServers": {
+    "datasinking": {
+      "type": "http",
+      "url": "https://api.datasink.ing/mcp?apikey=YOUR_KEY"
+    }
+  }
+}
+```
+
+Claude Code, in one line:
+
+```bash
+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.
+
+### Local — run it yourself
+
+If you'd rather keep everything on your own machine:
+
 ```bash
 pip install "datasinking[mcp]"
 datasinking-mcp          # requires DATASINK_API_KEY (free at https://datasink.ing)
 ```
 
-Or add to your client with `command: datasinking-mcp`. A remote streamable-HTTP endpoint
-is also live at `https://api.datasink.ing/mcp`. See [`mcp-server.md`](mcp-server.md).
+Then use `command: datasinking-mcp` in your client.
+
+Full per-client setup: [`mcp-server.md`](mcp-server.md).
 
 ![DataSinking MCP in Claude](docs/images/mcp-demo.png)
 

{datasinking-0.2.8 → datasinking-0.2.9}/README.md

@@ -8,27 +8,58 @@
 **Full-text financial reports across Asia, as clean Markdown.**
 
 [DataSinking](https://datasink.ing) serves **full-text financial reports** — annual, semi-annual
-and quarterly — from **China, Korea and Japan** as clean **Markdown**, ready for LLM reading
-and RAG. Query by FMP-style symbol (`600519.SS`, `005930.KS`, `7203.T`) 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.
+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
+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.
 
 ---
 
 ## MCP server
 
-Ship DataSinking to any AI agent (Claude Desktop / Cursor / Codex / Windsurf) as an
+Ship DataSinking to any AI agent (Claude / Cursor / Codex / Windsurf) 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:
+
+```json
+{
+  "mcpServers": {
+    "datasinking": {
+      "type": "http",
+      "url": "https://api.datasink.ing/mcp?apikey=YOUR_KEY"
+    }
+  }
+}
+```
+
+Claude Code, in one line:
+
+```bash
+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.
+
+### Local — run it yourself
+
+If you'd rather keep everything on your own machine:
+
 ```bash
 pip install "datasinking[mcp]"
 datasinking-mcp          # requires DATASINK_API_KEY (free at https://datasink.ing)
 ```
 
-Or add to your client with `command: datasinking-mcp`. A remote streamable-HTTP endpoint
-is also live at `https://api.datasink.ing/mcp`. See [`mcp-server.md`](mcp-server.md).
+Then use `command: datasinking-mcp` in your client.
+
+Full per-client setup: [`mcp-server.md`](mcp-server.md).
 
 ![DataSinking MCP in Claude](docs/images/mcp-demo.png)
 

{datasinking-0.2.8 → datasinking-0.2.9}/datasinking/_version.py

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

{datasinking-0.2.8 → datasinking-0.2.9}/datasinking/mcp_server.py

@@ -2,7 +2,7 @@
 """DataSinking MCP server (Model Context Protocol).
 
 Expose the DataSinking API — full-text financial reports across Asia
-(China, Korea, Japan) as clean Markdown — to AI agents (Claude, Cursor,
+(China, Korea, Japan, Taiwan) as clean Markdown — to AI agents (Claude, Cursor,
 Codex, DeepSeek, Windsurf, …).
 
 Install the MCP extra::
@@ -127,10 +127,15 @@ def get_report(
 def list_sections(
     document_id: Annotated[int, Field(description="Report id, from list_reports items[].id")],
 ) -> dict:
-    """List every section heading in a report (feed the headings to get_section).
+    """List every section of a report with its size — call this before pulling anything.
 
-    Call this before get_section to see the exact headings — the headings are in the
-    report's own language.
+    Returns ``sections`` (titles, in order) plus ``section_details``: the same list as
+    objects with ``title``, ``has_tables``, ``chars`` and ``estimated_tokens``.
+
+    Use ``estimated_tokens`` to avoid pulling a chapter that would blow your context,
+    and ``has_tables`` to know whether a chapter needs special handling (tables are the
+    part RAG pipelines usually get wrong). Then call get_section with a heading keyword —
+    the headings are in the report's own language.
     """
     return _get(f"/documents/{document_id}/sections")
 

{datasinking-0.2.8 → datasinking-0.2.9}/datasinking.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datasinking
-Version: 0.2.8
+Version: 0.2.9
 Summary: Python client for DataSinking — full-text Asian financial reports (China, Korea, Japan, Taiwan) as Markdown.
 Author: DataSinking
 License: MIT
@@ -31,27 +31,58 @@ Dynamic: license-file
 **Full-text financial reports across Asia, as clean Markdown.**
 
 [DataSinking](https://datasink.ing) serves **full-text financial reports** — annual, semi-annual
-and quarterly — from **China, Korea and Japan** as clean **Markdown**, ready for LLM reading
-and RAG. Query by FMP-style symbol (`600519.SS`, `005930.KS`, `7203.T`) 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.
+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
+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.
 
 ---
 
 ## MCP server
 
-Ship DataSinking to any AI agent (Claude Desktop / Cursor / Codex / Windsurf) as an
+Ship DataSinking to any AI agent (Claude / Cursor / Codex / Windsurf) 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:
+
+```json
+{
+  "mcpServers": {
+    "datasinking": {
+      "type": "http",
+      "url": "https://api.datasink.ing/mcp?apikey=YOUR_KEY"
+    }
+  }
+}
+```
+
+Claude Code, in one line:
+
+```bash
+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.
+
+### Local — run it yourself
+
+If you'd rather keep everything on your own machine:
+
 ```bash
 pip install "datasinking[mcp]"
 datasinking-mcp          # requires DATASINK_API_KEY (free at https://datasink.ing)
 ```
 
-Or add to your client with `command: datasinking-mcp`. A remote streamable-HTTP endpoint
-is also live at `https://api.datasink.ing/mcp`. See [`mcp-server.md`](mcp-server.md).
+Then use `command: datasinking-mcp` in your client.
+
+Full per-client setup: [`mcp-server.md`](mcp-server.md).
 
 ![DataSinking MCP in Claude](docs/images/mcp-demo.png)