DeepSeek Harness (DSH) emphasizes a plugin-based architecture. In academic research scenarios, developers often face challenges such as difficulty in multi-source retrieval, cumbersome full-text acquisition, and fragmented journal evaluation. The xby-article plugin, developed based on the FastMCP framework, is designed to address these pain points and provide one-stop literature processing capabilities.

Plugin Positioning

xby-article is a networked tools plugin maintained by xby-skill. It supports multi-source literature search and metadata retrieval, and can also retrieve full texts by PMCID, analyze literature relationships, and integrate EasyScholar and OpenAlex for journal quality evaluation.

Core Features

API Configuration

Use set_xby_apikey to configure the API key in chat. This configuration is automatically persisted and remains valid after restart.

Use search_literature to perform multi-source literature search. This tool returns only metadata (title, authors, abstract, PMCID, etc.) and does not include full-text content. To obtain the full text, use the PMCID returned in the results to call the follow-up tool.

The search strategy supports the following modes:
* comprehensive: Comprehensive search, using all available data sources.
* fast: Fast search, using only primary data sources.
* precise: Precise search, using only authoritative data sources.
* preprint: Preprint search.

Full-Text Retrieval

Use get_article_details to retrieve the full text of a literature item via PMCID. A PMCID identifier is required.
* Batch mode supports up to 20 PMCIDs.
* Supports section-based extraction (such as methods, discussion, conclusion) and specified formats (Markdown/Text/XML).

Reference Management

Use get_references to retrieve the reference list of a literature item. Queries are supported via DOI, PMID, or PMCID. This tool has a built-in smart deduplication mechanism, prioritizing deduplication by DOI and then by title.

Literature Relationship Analysis

Use get_literature_relations to analyze citation, similarity, and cited-by relationships among literature items. It supports analyzing a single or multiple literature identifiers.

Journal Quality Evaluation

Use get_journal_quality to evaluate the academic quality and impact indicators of a journal. This tool integrates two data sources: EasyScholar and OpenAlex.

Installation and Activation

Run the following command in the terminal to install:

dsh plugin --profile web add github:xby_skill/xby-article

After installation, the plugin can be used in DSH’s Web Profile.

Typical Usage

  1. Set the Key: Enter a command in chat to set the API key, for example set_xby_apikey <your_key>.
  2. Search Literature: Use search_literature to search for keywords. For example, set the search strategy to precise to obtain more authoritative results.
  3. Retrieve Full Text: Using the PMCID returned from the search, call get_article_details to retrieve the full-text content of specified sections.
  4. Analyze Relationships: Enter the DOI of a publication and call get_literature_relations to view its citation network.
  5. Evaluate Journal: Enter the journal name and call get_journal_quality to obtain metrics such as impact factor and SCI quartile.

Notes

  • Data Source Limitation: search_literature returns only metadata and does not include full text. To obtain full text, you must first retrieve the PMCID through search and then call get_article_details.
  • Parameter Requirements: get_article_details requires a valid PMCID. get_references supports smart deduplication.
  • Data Sources: get_journal_quality depends on two external data sources: EasyScholar and OpenAlex.

Summary

xby-article provides DeepSeek Harness with a complete literature processing pipeline, from retrieval to evaluation. Developers can leverage its multi-source search, full-text extraction, and relationship analysis capabilities to quickly build professional academic assistant applications. For more details, visit GitHub.