記事取得

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

仕様

コマンド形式

esa-cli fetch <article_number>

パラメータ

• article_number - ダウンロードする記事の番号（必須）

記事番号の取得

記事番号はlistコマンドで確認できます。記事番号が分からない場合は、まずesa-cli listで記事一覧を確認してください。

オプション

• -c, --category - カテゴリでフィルタ
• -t, --tag - タグでフィルタ
• -q, --query - 検索ワードでフィルタ
• -u, --user - 作成者でフィルタ
• -l, --latest - 最新の記事をダウンロード

ファイル形式

記事は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: リモート記事の最終更新日時（更新時の変更チェックに使用）

ファイル名の重要性

ファイル名はupdateコマンドで記事を更新する際に重要です。記事番号-タイトル.mdの形式を維持してください。

使用例

基本的な使用方法

# 記事番号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

一括ダウンロード

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

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

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

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

バックアップ

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

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

注意事項

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