# Obsidian Content Importer

> Use when a user gives one or many WeChat or Xiaohongshu links and wants the parsed notes saved to a specific local path without relying on the Obsidian plugin UI. This skill wraps the repository's import capability as a direct agent tool through the bundled script, including batch import, frontmatter generation, media download, and JSON result reporting.

- Skill: `tomevault-io/obsidian-content-importer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/obsidian-content-importer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/obsidian-content-importer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/obsidian-content-importer

---


# Obsidian Content Importer

This skill is for direct execution, not for extending the plugin.

- Humans can keep using the Obsidian plugin UI.
- Agents should use this skill's script to import links directly.
- The target path can be any local folder. If it is inside an Obsidian vault, the notes become available there automatically.

## What this skill does

Given one link or a batch of links, the script will:

1. Detect supported platforms: WeChat or Xiaohongshu
2. Fetch and parse the page
3. Convert content into Markdown
4. Write note files into the requested output directory
5. Optionally download media into `media/<title>/`
6. Return a JSON summary with created files and failures

## Use this script

Bundled executable: [`scripts/import-content.mjs`](scripts/import-content.mjs)

Run it with:

```bash
node scripts/import-content.mjs --output-dir "/absolute/output/path" --category "研究" --url "https://mp.weixin.qq.com/s/xxxx"
```

Batch import:

```bash
node scripts/import-content.mjs --output-dir "/absolute/output/path" --category "研究" --download-media --input-file "/tmp/links.txt"
```

Multiple URLs directly:

```bash
node scripts/import-content.mjs \
  --output-dir "/absolute/output/path" \
  --url "https://mp.weixin.qq.com/s/xxxx" \
  --url "https://www.xiaohongshu.com/discovery/item/xxxx"
```

Install check:

```bash
node ~/.codex/skills/obsidian-content-importer/scripts/import-content.mjs --help
node ~/.claude/skills/obsidian-content-importer/scripts/import-content.mjs --help
```

## Agent workflow

1. Decide the output directory with the user or infer it from context.
2. Prefer repeated `--url` for a small batch; use `--input-file` for larger batches.
3. Add `--download-media` only when local media is actually needed.
4. Parse the JSON result and report:
   - created note paths
   - failed links and reasons
   - skipped invalid lines

If the skill seems missing after installation:

1. Confirm the final path ends with `obsidian-content-importer/SKILL.md` rather than an extra nested directory.
2. Confirm `scripts/import-content.mjs` exists beside `SKILL.md`.
3. Start a fresh agent session and invoke the skill by name in the task.

## Output contract

- Notes: `<output-dir>/<title>.md`
- Media: `<output-dir>/media/<title>/...`
- Common frontmatter: `platform`, `title`, `source`, `category`, `imported_at`, `cover`, `type`
- WeChat also writes: `account`, `wechat_id`, `alias`, `author`, `published_at`, `published_ts`, `description`

---
> Source: [hztBUAA/all-in-obs](https://github.com/hztBUAA/all-in-obs) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-22 -->