markdown downloader

Local 2025-08-31 23:51:27 0

Browser Automation @dazeb/markdown-downloader

An MCP server that enables users to download webpages as markdown files using r.jina.ai service, with features for configurable download directories and automatic date-stamped filenames.

Overview

Markdown Downloader is a powerful MCP (Model Context Protocol) server that allows you to download webpages as markdown files with ease. Leveraging the r.jina.ai service, this tool provides a seamless way to convert web content into markdown format.

Features

? Download webpages as markdown using r.jina.ai
? Configurable download directory
? Automatically generates date-stamped filenames
? List downloaded markdown files
? Persistent configuration

Prerequisites

Node.js (version 16 or higher)
npm (Node Package Manager)

Installation

Clone the repository:

git clone https://github.com/your-username/markdown-downloader.git
cd markdown-downloader

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Manually Add Server to Cline/Roo-Cline MCP Settings file

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
      ]
    }
  }
}

Tools and Usage

1. Set Download Directory

Change the download directory:

use set_download_directory /path/to/your/local/download/folder

Validates directory exists and is writable
Persists the configuration for future use

2. Download Markdown

Download a webpage as a markdown file:

use tool download_markdown https://example.com/blog-post

The URL will be prepended with r.jina.ai
Filename format: {sanitized-url}-{date}.md
Saved in the configured download directory

3. List Downloaded Files

List all downloaded markdown files:

use list_downloaded_files

4. Get Download Directory

Retrieve the current download directory:

use get_download_directory

Configuration

Configuration is stored in ~/.config/markdown-downloader/config.json
Default download directory: ~/.markdown-downloads

Troubleshooting

Ensure you have an active internet connection
Check that the URL is valid and accessible
Verify write permissions for the download directory

Security

The tool uses r.jina.ai to fetch markdown content
Local files are saved with sanitized filenames
Configurable download directory allows flexibility

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Disclaimer

This tool is provided as-is. Always review downloaded content for accuracy and appropriateness.

Support

For issues or feature requests, please open an issue on the GitHub repository.

[
  {
    "description": "Download a webpage as markdown using r.jina.ai",
    "inputSchema": {
      "properties": {
        "subdirectory": {
          "description": "Optional subdirectory to save the file in",
          "type": "string"
        },
        "url": {
          "description": "URL of the webpage to download",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "name": "download_markdown"
  },
  {
    "description": "List all downloaded markdown files",
    "inputSchema": {
      "properties": {
        "subdirectory": {
          "description": "Optional subdirectory to list files from",
          "type": "string"
        }
      },
      "type": "object"
    },
    "name": "list_downloaded_files"
  },
  {
    "description": "Set the main local download folder for markdown files",
    "inputSchema": {
      "properties": {
        "directory": {
          "description": "Full path to the download directory",
          "type": "string"
        }
      },
      "required": [
        "directory"
      ],
      "type": "object"
    },
    "name": "set_download_directory"
  },
  {
    "description": "Get the current download directory",
    "inputSchema": {
      "properties": {},
      "type": "object"
    },
    "name": "get_download_directory"
  },
  {
    "description": "Create a new subdirectory in the root download folder",
    "inputSchema": {
      "properties": {
        "name": {
          "description": "Name of the subdirectory to create",
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "name": "create_subdirectory"
  }
]