---
title: research note
description: noteの記事・作者・トピックを調べる。
canonical_url: https://orchestor.io/docs/cli/research/note
markdown_url: https://orchestor.io/docs/cli/research/note.md
contentType: reference
---

# research note

`orc research note` は、noteの記事を検索し、作者・ハッシュタグ・トピックから公開記事を探すコマンドです。発見した記事IDから本文やコメントを取得し、作者プロフィールを確認できます。

認証済みのCLIと、アクセス可能なWorkspaceが必要です。`--workspace` で今回の対象を指定できます。

## 使い方

```bash title="terminal"
orc research note articles search --q "生成AI" --workspace <workspace-id> --json
```

*公開記事を検索する。*

## サブコマンド

### `articles search`

`--q` の語句でnoteの記事を検索します。発見した記事IDを使い、本文やコメントを個別に取得できます。

```bash title="terminal"
orc research note articles search [options]
```

#### 固有のオプション

##### `--q`

Search text; 1–200 characters. URL-encode when building a request.; max 200 chars

型: `string`。必須。

```bash title="terminal"
orc research note articles search --q <value>
```

##### `--sort`

Native note ordering: popular, newest, or hot.; enum: popular|new|hot

型: `string`。任意。

```bash title="terminal"
orc research note articles search --sort <value>
```

##### `--start`

Use pagination.next_start from the previous response; keep other search parameters unchanged.; (use "null" or "reset" to clear)

型: `number`。任意。

```bash title="terminal"
orc research note articles search --start <value>
```

##### `--paid`

true selects the source sales collection; it does not unlock paid bodies.; enum: true|false

型: `string`。任意。

```bash title="terminal"
orc research note articles search --paid <value>
```

### `articles get`

記事IDを指定してnoteの記事を取得します。URLではなく一覧にあるIDを使います。

```bash title="terminal"
orc research note articles get <id> [options]
```

### `creators get`

作者のnameを指定して公開プロフィールを取得します。記事一覧の作者情報から対象を選べます。

```bash title="terminal"
orc research note creators get <name> [options]
```

### `hashtags get`

ハッシュタグ名を指定して、そのタグの公開情報を取得します。

```bash title="terminal"
orc research note hashtags get <name> [options]
```

### `hashtags articles list`

ハッシュタグ名に関連する記事を一ページ取得します。

```bash title="terminal"
orc research note hashtags articles list <name> [options]
```

#### 固有のオプション

##### `--page`

One-based native page number; use the returned continuation.

型: `number`。任意。

```bash title="terminal"
orc research note hashtags articles list <name> --page <value>
```

### `interests get`

関心分野のnameを指定して公開情報を取得します。

```bash title="terminal"
orc research note interests get <name> [options]
```

#### 固有のオプション

##### `--page`

One-based native page number; use the returned continuation.

型: `number`。任意。

```bash title="terminal"
orc research note interests get <name> --page <value>
```

### `map`

noteのトピックや取得機能の入口を確認します。返されたトピックのpathを `topics get` に指定できます。

```bash title="terminal"
orc research note map [options]
```

### `tags get`

タグ名を指定してタグの公開情報を取得します。

```bash title="terminal"
orc research note tags get <name> [options]
```

#### 固有のオプション

##### `--mode`

Native tag ordering. Keep the mode unchanged when following the returned cursor; switching it starts a different collection.; enum: popular|new

型: `string`。任意。

```bash title="terminal"
orc research note tags get <name> --mode <value>
```

### `topics get`

`map` で確認したトピックのpathを `--path` へ渡し、そのトピックを取得します。階層を持つpathにも対応します。

```bash title="terminal"
orc research note topics get [options]
```

#### 固有のオプション

##### `--page`

One-based page within the selected topic and tab. Use the returned continuation; some curated layouts only expose their initial page.

型: `number`。任意。

```bash title="terminal"
orc research note topics get --page <value>
```

##### `--tab`

Native topic tab identifier. Follow api_url in data.pages to select a tab. When omitted, the source top tab is selected.

型: `string`。任意。

```bash title="terminal"
orc research note topics get --tab <value>
```

##### `--path`

Topic ID from map; nested paths are supported.; max 200 chars

型: `string`。必須。

```bash title="terminal"
orc research note topics get --path <value>
```

### `trends list`

noteが掲載するトレンドのセクションを取得します。原典の掲載範囲と順序を保持します。

```bash title="terminal"
orc research note trends list [options]
```

#### 固有のオプション

##### `--page`

One-based native page number; use the returned continuation.

型: `number`。任意。

```bash title="terminal"
orc research note trends list --page <value>
```

### `articles comments list`

指定記事のコメントを一ページ取得します。続きを取得するときは対象記事と検索条件を維持してください。

```bash title="terminal"
orc research note articles comments list <id> [options]
```

#### 固有のオプション

##### `--page`

One-based native page number; use the returned continuation.

型: `number`。任意。

```bash title="terminal"
orc research note articles comments list <id> --page <value>
```

### `creators articles list`

作者のnameを指定して公開記事を一覧表示します。表示名ではなく取得元の作者識別子を使います。

```bash title="terminal"
orc research note creators articles list <name> [options]
```

#### 固有のオプション

##### `--page`

One-based native page number; use the returned continuation.

型: `number`。任意。

```bash title="terminal"
orc research note creators articles list <name> --page <value>
```

## 使用例

### トピックの公開情報を取得する。

```bash title="terminal"
orc research note topics get --path challenge --workspace <workspace-id> --json
```

*トピックの公開情報を取得する。*

### ハッシュタグの情報を取得する。

```bash title="terminal"
orc research note hashtags get "生成AI" --workspace <workspace-id> --json
```

*ハッシュタグの情報を取得する。*

## 出力とページ送り

一覧は一回の呼び出しで一ページを取得します。返された `pagination.next_url` のクエリ値を、対応するフラグへ渡して続きを取得してください。検索条件は維持します。継続情報が不明でも全件取得済みとは判断せず、`--page-all` による自動巡回は行いません。

`--json` ではAPIレスポンス全体をCLIの `data` に保持します。取得内容は `data.data`、継続情報は `data.pagination`、取得元情報は `data.source` です。`--raw` はCLIの外枠を外し、`--field data` はAPIのデータだけを選択します。欠損値やnullを0として扱わないでください。

## 必要な権限

APIキーではreadスコープが必要です。 プロバイダーのキーはサーバー側で管理します。

## グローバルオプション

`orc research note` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5)
- [`--limit`](https://orchestor.io/docs/cli/global-flags.md)
- [`--cursor`](https://orchestor.io/docs/cli/global-flags.md)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93)

各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。

## 関連項目

- 調査CLIの概要
- [グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)