ja-JP/about_QiitaDrive.help.txt
|
TOPIC
about_QiitaDrive SHORT DESCRIPTION Qiita API v2 に接続し、記事をファイルシステムとして閲覧する PowerShell プロバイダです。 LONG DESCRIPTION QiitaDrive は PowerShell の NavigationCmdletProvider を実装し、Qiita の記事をドライブとして マウントします。dir, cd, Get-Content などの標準コマンドで記事を閲覧できます。 ドライブのマウント # OAuth 認証 (ブラウザが開きます) New-QiitaDrive # トークン指定 New-QiitaDrive -Token $env:QIITA_TOKEN # Qiita Team New-QiitaDrive -Name MyTeam -Team myteamname フォルダ構造 Qiita:\ +-- CachedItems\ キャッシュ済みの記事一覧 +-- ItemDetails\ 記事の詳細情報 | +-- <記事名>\ | +-- Comments\ コメント (Get-Content 対応) | +-- Likes\ いいねしたユーザー | +-- Stockers\ ストックしたユーザー +-- LatestItems\ Qiita 全体の新着記事 +-- Tags\ タグ別の記事を閲覧 | +-- PowerShell\ タグ内の記事 +-- Users\ ユーザー別の記事を閲覧 | +-- ytsuda\ ユーザーの記事 +-- Search\ 記事を検索 | +-- query\ 検索結果 +-- Me\ 自分の記事・ストック・フォロー | +-- Items\ 投稿した記事 | +-- Stocks\ ストックした記事 | +-- Followers\ フォロワー | | +-- ytsuda\ ユーザーの記事 | +-- FollowingTags\ フォロー中のタグ | | +-- Git\ タグ内の記事 | +-- FollowingUsers\ フォロー中のユーザー | +-- ytsuda\ ユーザーの記事 +-- Team\ チーム管理 (Team 接続時のみ) +-- Members\ +-- Invitations\ +-- Groups\ +-- Templates\ dir (Get-ChildItem) # タグ内の記事一覧 (既定: 20件) dir Qiita:\Tags\PowerShell # 件数指定 dir Qiita:\Tags\PowerShell -First 50 # ページネーション dir Qiita:\Tags\PowerShell -First 20 -Skip 40 # キャッシュを無視して再取得 dir Qiita:\Tags\PowerShell -Force # 再帰表示 (フォルダ + 記事) dir Qiita:\ -Recurse -First と -Skip は QiitaDrive 固有の動的パラメータです。 既定では20件取得します。API の制限により、1回のリクエストで最大100件です。 cd (Set-Location) # タグフォルダに移動 cd Qiita:\Tags\PowerShell # 検索結果に移動 (自動的に検索実行) cd Qiita:\Search\PowerShell 入門 # ユーザーの記事に移動 cd Qiita:\Users\ytsuda タブ補完が使用できます。Tags フォルダでは人気タグ上位100件が補完候補になります。 Get-Content (記事の本文を読む) # 記事の本文を表示 Get-Content Qiita:\Tags\PowerShell\abc1234_Title.md # パイプラインで利用 Get-Content Qiita:\Me\Items\abc1234_Title.md | Select-String "pattern" 記事の本文は初回アクセス時に API から取得され、キャッシュされます。 出力は Markdown 形式で、タイトル・著者・日付・タグのヘッダー付きです。 Copy-QiitaItem (記事をファイルにコピー) # 1件コピー Copy-QiitaItem Qiita:\Me\Items\abc1234_Title.md C:\articles\ # ワイルドカードで一括コピー Copy-QiitaItem Qiita:\Tags\PowerShell\*.md C:\temp\ # パターン指定 Copy-QiitaItem Qiita:\Me\Items\*git*.md C:\articles\ # パイプラインでコピー dir Qiita:\Me\Items -First 10 | Copy-QiitaItem -Destination C:\backup\ PowerShell の Copy-Item は異なるプロバイダ間のコピーに対応していないため、 この関数が代替手段を提供します。 自分の記事をトラックする # 自分の全記事を一覧(いいね・ストック・PV 付き) dir Qiita:\Me\Items -First 100 # いいね数でランキング dir Qiita:\Me\Items -First 100 | Sort-Object LikesCount -Descending | Select-Object Title, LikesCount, StocksCount, PageViewsCount # 統計サマリー dir Qiita:\Me\Items -First 100 | Measure-Object -Property LikesCount, StocksCount, PageViewsCount -Sum -Average # 記事のパフォーマンスを CSV にエクスポート dir Qiita:\Me\Items -First 100 | Select-Object Title, LikesCount, StocksCount, PageViewsCount, CommentsCount, CreatedAt | Export-Csv -Path my-articles.csv -NoTypeInformation # 自分の記事をローカルにバックアップ cd Qiita:\Me\Items; dir -First 100 Copy-QiitaItem * C:\backup\qiita\ Me\Items では PageViewsCount(PV 数)が取得でき、Private(限定公開)フラグも確認できます。 フォロー中のユーザー / フォロワーの記事を閲覧する # フォロー中のユーザー一覧 dir Qiita:\Me\FollowingUsers # フォロワー一覧 dir Qiita:\Me\Followers # 特定ユーザーの記事 dir Qiita:\Me\FollowingUsers\someone # フォロー中ユーザーの記事をまとめてコピー dir Qiita:\Me\FollowingUsers\someone | Copy-QiitaItem -Destination C:\articles\ Invoke-Item (既定のアプリで開く) # 記事を一時ファイルとして保存し、既定のアプリで開く ii Qiita:\Tags\PowerShell\abc1234_Title.md # フォルダの場合は Qiita Web ページをブラウザで開く ii Qiita:\Tags\PowerShell Get-QiitaItem (URL/ID で記事を取得) # URL で記事を取得 (Body 含む QiitaItem) Get-QiitaItem https://qiita.com/ytsuda/items/1c6bf5d89a0b4e... # 短縮 ID で取得 (キャッシュ内のみ) Get-QiitaItem 1c6bf5d # パイプラインで複数 "id1", "id2" | Get-QiitaItem Resolve-QiitaPath (URL/ID をプロバイダパスに変換) # URL → プロバイダパス Resolve-QiitaPath https://qiita.com/ytsuda/items/1c6bf5d89a0b4e... # パイプラインで Get-Content に渡す Resolve-QiitaPath https://qiita.com/... | Get-Content Search-QiitaContent (キャッシュ済み記事の本文を検索) # キャッシュ済み記事から正規表現で検索 Search-QiitaContent "PowerShell" # 特定パス内を検索 Search-QiitaContent "pattern" -Path Qiita:\Tags\PowerShell Open-QiitaPage (Qiita Web ページを開く) # 記事ページを開く Open-QiitaPage Qiita:\Tags\PowerShell\abc1234_Title.md # パイプラインから dir Qiita:\Me\Items | Select-Object -First 1 | Open-QiitaPage Remove-Item (キャッシュの削除) # 検索クエリのキャッシュを削除 Remove-Item Qiita:\Search\古いクエリ # タグフォルダのキャッシュを削除 Remove-Item Qiita:\Tags\PowerShell # ワイルドカードで一括削除 cd Qiita:\Tags; Remove-Item * QiitaDrive は読み取り専用です。 Remove-Item は Tags, Users, Search, ItemDetails フォルダのキャッシュ削除に対応しています。 キャッシュの動作 QiitaDrive はインメモリキャッシュを使用します。 - 記事メタデータ: dir 実行時に自動キャッシュ - 記事本文: Get-Content 実行時に自動キャッシュ - タグメタデータ: タグフォルダへの初回アクセス時にキャッシュ - キャッシュに TTL はありません - dir -Force でフォルダ単位のキャッシュを再取得 - Clear-QiitaCache で明示的にクリア 記事のファイル名 記事は {短縮ID}_{タイトル}.md の形式で表示されます。 c3f4_MCP 時代の到来とアプリ開発の新常識.md 短縮 ID は Git と同様のアルゴリズムで、キャッシュ内の全記事で一意になる 最短長 (既定4文字) が自動計算されます。 SEE ALSO New-QiitaDrive Get-QiitaItem Resolve-QiitaPath Copy-QiitaItem Search-QiitaContent Open-QiitaPage Clear-QiitaCache |