Mdtero Docs

English

简体中文

English

简体中文

Appearance

Human And Agent Overview ​

Mdtero supports two entry points that produce the same structured Markdown: a browser extension for one paper at a time, and a Python CLI for repeatable projects and local agents.

Local Workflow ​

bash
uv tool install --upgrade mdtero
mdtero setup
mdtero doctor --json

Use the CLI to discover papers, parse a DOI or a saved file, download Markdown, and translate it:

bash
mdtero discover "thermal energy storage" --limit 5 --interactive
mdtero parse <doi-or-url> --wait --timeout 300 --json
mdtero parse --file paper.pdf --wait --timeout 600 --json
mdtero download <task-id> paper_md --output-dir ./mdtero-output --json
mdtero translate <task-id> --to zh-CN --wait --timeout 600 --json

Use the extension when a source is already open in your browser, relies on your own sign-in or institutional access, or when you want to select a saved file. It does not grant access to material your account is not authorized to read.

Project Workflow ​

bash
mdtero project init --name literature-review
mdtero project add <doi-or-url> --json
mdtero project import-bib references.bib --json
mdtero project parse --wait --timeout 300 --json
mdtero project download --output-dir ./project-out --json

Zotero support is conservative. mdtero zotero sync adds Mdtero result notes and tags for matching succeeded items; it does not rewrite Zotero bibliographic metadata.

Agent Workflow ​

bash
mdtero doctor --json
mdtero mcp briefing --json
mdtero mcp serve

Start a local agent with the health check or briefing. It receives safe task state, available downloads, quality notices, citations, and suggested next steps. Do not place API keys or other secrets in prompts, logs, or copied handoffs.

Project Questions ​

After documents are processed, query the project and retain citations in any research conclusion:

bash
mdtero rag query "What are the strongest findings?" --build-if-needed --json

The explicit mdtero rag status and mdtero rag build --wait --json commands are available when you need to inspect or refresh project readiness.

Public Contract ​

The stable user-facing contract is task submission, status, download, translation, and cited project questions. See API Reference for direct API integration. Parser selection, source acquisition, and service implementation are managed by Mdtero and are not user-selectable options.