# Magicmd

> Use when the user wants public article URLs from WeChat, Juejin, CSDN, or technical blogs converted into Markdown packages, including batch conversion, local media, metadata, and extraction reports.

- **Type:** Skill
- **Install:** `agentstack add skill-didilili-magicmd-magicmd`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [didilili](https://agentstack.voostack.com/s/didilili)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [didilili](https://github.com/didilili)
- **Source:** https://github.com/didilili/MagicMD/tree/main/skills/magicmd
- **Website:** https://MagicMD.cn

## Install

```sh
agentstack add skill-didilili-magicmd-magicmd
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MagicMD

MagicMD converts public article links into Markdown packages. Use it as a thin tool wrapper: call the published CLI, inspect the output, and report what was created.

## User-Facing Prompts

When users are not sure what to ask, suggest concise prompts like these:

```text
Use MagicMD to convert this public article into a Markdown package, then summarize the output files and warnings.
```

```text
Read urls.txt, batch convert all public article links into output/articles with MagicMD, skip existing packages, and report failures from batch-report.md.
```

```text
Use MagicMD doctor to check whether this workspace can convert WeChat, Juejin, CSDN, and generic article links.
```

```text
Inspect this MagicMD output directory and tell me which articles need manual review before publishing.
```

## When to Use

Use this skill for:

- Single public article URL to Markdown conversion.
- Batch conversion from a URL list.
- WeChat Official Account, Juejin, CSDN, and generic public article pages.
- Agent workflows that need `article.md`, metadata, local images, videos, or extraction reports before publishing elsewhere.

Do not use it to bypass login, paywalls, private pages, CAPTCHA, rate limits, or platform access controls.

## Command Choice

Prefer an installed CLI when available:

```bash
magicmd doctor
magicmd "" -o output/
magicmd batch urls.txt -o output/
```

If `magicmd` is not installed, use the PyPI package through `uvx`:

```bash
uvx --from magicmd magicmd doctor
uvx --from magicmd magicmd "" -o output/
uvx --from magicmd magicmd batch urls.txt -o output/
```

For repeated batch runs:

```bash
magicmd batch urls.txt -o output/ --skip-existing
magicmd batch urls.txt -o output/ --overwrite
```

## Workflow

1. Run `magicmd doctor` when the environment is unknown.
2. Put multiple URLs in a plain text file, one URL per line.
3. Convert with `magicmd "" -o ` or `magicmd batch  -o `.
4. Verify each output package contains `article.md`, `metadata.json`, and `extraction-report.json`.
5. Check local media directories such as `images/` or `videos/` when media download is enabled.
6. For batch jobs, inspect `batch-report.md` and `batch-report.json`.
7. If conversion is incomplete, inspect `extraction-report.json`, `debug.html` when present, and the source URL.

## Reporting Back

Tell the user:

- Output directory path.
- Number of successful and failed conversions.
- Important warnings from `extraction-report.json` or `batch-report.md`.
- Whether media was downloaded locally.
- Any limits encountered, such as 403, login requirement, video hotlink protection, or missing dynamic resources.
- Next suggested action: publish, manually review, retry with browser support, or collect failure evidence.

Keep the original URL and output package intact so the user can compare against the source page.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [didilili](https://github.com/didilili)
- **Source:** [didilili/MagicMD](https://github.com/didilili/MagicMD)
- **License:** MIT
- **Homepage:** https://MagicMD.cn

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-didilili-magicmd-magicmd
- Seller: https://agentstack.voostack.com/s/didilili
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.