Skip to content

記事取得

esa.ioの記事をダウンロードします。記事はMarkdown形式で保存され、ファイル名は記事番号とタイトルから自動生成されます。

仕様

コマンド形式

esa-cli fetch <article_number>

パラメータ

article_number - ダウンロードする記事の番号（-lオプション未使用時は必須）

オプション

-c, --category - カテゴリでフィルタ（-lオプションと併用時のみ有効）
-t, --tag - タグでフィルタ（-lオプションと併用時のみ有効）
-q, --query - 検索ワードでフィルタ（-lオプションと併用時のみ有効）
-u, --user - 作成者でフィルタ（-lオプションと併用時のみ有効）
-l, --latest - 最新の記事をダウンロード（フィルタリングオプションと併用可能）
-p, --print - ファイルに保存せず標準出力に表示（AIエディタなどでの参照に便利）

ファイル形式

記事はMarkdown形式で保存され、以下の命名規則に従います：

<article_number>-<article-title>.md

ファイル構造

---
title: 記事のタイトル
category: カテゴリ
tags: [tag1, tag2]
wip: false
remote_updated_at: "2025-06-21T09:32:41+09:00"
---

記事の本文...

メタデータフィールドの説明：

title: 記事のタイトル
category: 記事のカテゴリ
tags: 記事のタグ（配列形式）
wip: WIP（Work In Progress）状態（true/false）
remote_updated_at: リモート記事の最終更新日時（更新時の変更チェックに使用）

使用例

基本的な使用方法

# 記事番号123の記事をダウンロード
esa-cli fetch 123

フィルタリングとダウンロード

# カテゴリの最新記事をダウンロード
esa-cli fetch -c 開発 -l
esa-cli fetch --category 開発 --latest

# タグの最新記事をダウンロード
esa-cli fetch -t API -l
esa-cli fetch --tag API --latest

# 作成者の最新記事をダウンロード
esa-cli fetch -u 自分のユーザー名 -l
esa-cli fetch --user 自分のユーザー名 --latest

# 検索ワードの最新記事をダウンロード
esa-cli fetch -q 認証 -l
esa-cli fetch --query 認証 --latest

標準出力への表示

# 記事を標準出力に表示（ファイル保存なし）
esa-cli fetch 123 -p
esa-cli fetch 123 --print

# 最新記事を標準出力に表示
esa-cli fetch -c 開発 -l -p

# パイプで他のコマンドに渡す
esa-cli fetch 123 -p | grep "キーワード"

# AIエディタなどで使用する場合
esa-cli fetch 123 -p > article.md  # ファイルにリダイレクト

一括ダウンロード

一括ダウンロードには fetch-all コマンドを使用することを推奨します：

# 特定のカテゴリの記事を一括ダウンロード
esa-cli fetch-all -c "開発/ドキュメント"

# 特定のタグの記事を一括ダウンロード
esa-cli fetch-all -t API

# 取得件数を制限して一括ダウンロード
esa-cli fetch-all -c 開発 --limit 5

バックアップ

# 特定の日付のバックアップディレクトリを作成
DATE=$(date +%Y%m%d)
BACKUP_DIR="./backup/$DATE"
mkdir -p "$BACKUP_DIR"

# 全記事をバックアップ
esa-cli fetch-all --limit 100
mv *-*.md "$BACKUP_DIR"

注意事項

記事番号は list コマンドで確認できます
ファイル名に使用できない文字は自動的に置換されます
同名のファイルが存在する場合は上書きされます
記事のメタデータ（タイトル、カテゴリ、タグ）はYAMLフロントマターとして保存されます