---
title: research x
description: Xのアカウントと投稿を調べる。
canonical_url: https://orchestor.io/docs/cli/research/x
markdown_url: https://orchestor.io/docs/cli/research/x.md
contentType: reference
---

# research x

`orc research x` は、Xのアカウント情報と投稿を取得し、保存済みの投稿を検索・分析するコマンドです。

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

## 使い方

```bash title="terminal"
orc research x accounts get <handle> --workspace <workspace-id> --json
```

*アカウント情報を取得する。*

## サブコマンド

### `accounts get`

Get X account

```bash title="terminal"
orc research x accounts get <handle> [options]
```

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

##### `--max-age`

Maximum cached age in seconds, scoped to this workspace. Zero fetches fresh. Each fresh page may incur provider charges.; (use "null" or "reset" to clear)

型: `number`。任意。

```bash title="terminal"
orc research x accounts get <handle> --max-age <value>
```

### `accounts posts list`

List X account posts

```bash title="terminal"
orc research x accounts posts list <handle> [options]
```

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

##### `--max-age`

Maximum cached age in seconds, scoped to this workspace. Zero fetches fresh. Each fresh page may incur provider charges.; (use "null" or "reset" to clear)

型: `number`。任意。

```bash title="terminal"
orc research x accounts posts list <handle> --max-age <value>
```

##### `--include-replies`

Include replies along with posts. Preserve this value while paging.; enum: true|false

型: `string`。任意。

```bash title="terminal"
orc research x accounts posts list <handle> --include-replies <value>
```

### `posts get`

Get X post

```bash title="terminal"
orc research x posts get <id> [options]
```

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

##### `--max-age`

Maximum cached age in seconds, scoped to this workspace. Zero fetches fresh. Each fresh page may incur provider charges.; (use "null" or "reset" to clear)

型: `number`。任意。

```bash title="terminal"
orc research x posts get <id> --max-age <value>
```

### `accounts post-observations import`

Import previously acquired X observations

```bash title="terminal"
orc research x accounts post-observations import <handle> [options]
```

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

##### `--observed-at`

(required) Fallback observation time for posts without their own timestamp.

型: `string`。任意。

```bash title="terminal"
orc research x accounts post-observations import <handle> --observed-at <value>
```

##### `--posts`

(required) Body field: posts; JSON array of objects (use --stdin for large resources)

型: `string`。任意。

```bash title="terminal"
orc research x accounts post-observations import <handle> --posts <value>
```

### `posts list`

Rank and search saved X posts

```bash title="terminal"
orc research x posts list [options]
```

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

##### `--handles`

Comma-separated timeline handles. Omit to query this workspace.

型: `string`。任意。

```bash title="terminal"
orc research x posts list --handles <value>
```

##### `--q`

Case-insensitive literal text substring, not a provider search.; max 300 chars

型: `string`。任意。

```bash title="terminal"
orc research x posts list --q <value>
```

##### `--since`

Inclusive publication time, UTC.

型: `string`。任意。

```bash title="terminal"
orc research x posts list --since <value>
```

##### `--until`

Exclusive publication time, UTC.

型: `string`。任意。

```bash title="terminal"
orc research x posts list --until <value>
```

##### `--authorship`

Compare source author with timeline account. Unknown authors are never inferred from timeline ownership.; enum: own|other|unknown|all

型: `string`。任意。

```bash title="terminal"
orc research x posts list --authorship <value>
```

##### `--post-type`

enum: all|original|reply|repost

型: `string`。任意。

```bash title="terminal"
orc research x posts list --post-type <value>
```

##### `--min-views`

(use "null" or "reset" to clear)

型: `number`。任意。

```bash title="terminal"
orc research x posts list --min-views <value>
```

##### `--sort`

enum: engagements|likes|reposts|replies|quotes|views|bookmarks|engagement_rate|published_at

型: `string`。任意。

```bash title="terminal"
orc research x posts list --sort <value>
```

##### `--order`

enum: desc|asc

型: `string`。任意。

```bash title="terminal"
orc research x posts list --order <value>
```

##### `--offset`

(use "null" or "reset" to clear)

型: `number`。任意。

```bash title="terminal"
orc research x posts list --offset <value>
```

##### `--as-of`

Freeze saved and observed records at this time. Preserve pagination.next_url for stable paging.

型: `string`。任意。

```bash title="terminal"
orc research x posts list --as-of <value>
```

##### `--group-by`

Analytics grouping; month uses UTC publication time.; enum: account|month|post_type

型: `string`。任意。

```bash title="terminal"
orc research x posts list --group-by <value>
```

### `posts analytics`

Analyze saved X posts

```bash title="terminal"
orc research x posts analytics [options]
```

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

##### `--handles`

Comma-separated timeline handles. Omit to query this workspace.

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --handles <value>
```

##### `--q`

Case-insensitive literal text substring, not a provider search.; max 300 chars

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --q <value>
```

##### `--since`

Inclusive publication time, UTC.

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --since <value>
```

##### `--until`

Exclusive publication time, UTC.

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --until <value>
```

##### `--authorship`

Compare source author with timeline account. Unknown authors are never inferred from timeline ownership.; enum: own|other|unknown|all

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --authorship <value>
```

##### `--post-type`

enum: all|original|reply|repost

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --post-type <value>
```

##### `--min-views`

(use "null" or "reset" to clear)

型: `number`。任意。

```bash title="terminal"
orc research x posts analytics --min-views <value>
```

##### `--sort`

enum: engagements|likes|reposts|replies|quotes|views|bookmarks|engagement_rate|published_at

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --sort <value>
```

##### `--order`

enum: desc|asc

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --order <value>
```

##### `--offset`

(use "null" or "reset" to clear)

型: `number`。任意。

```bash title="terminal"
orc research x posts analytics --offset <value>
```

##### `--as-of`

Freeze saved and observed records at this time. Preserve pagination.next_url for stable paging.

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --as-of <value>
```

##### `--group-by`

Analytics grouping; month uses UTC publication time.; enum: account|month|post_type

型: `string`。任意。

```bash title="terminal"
orc research x posts analytics --group-by <value>
```

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

`orc research x` では、次の[グローバルオプション](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)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#%E8%AA%AD%E3%81%BF%E5%8F%96%E3%82%8A%E5%B0%82%E7%94%A8%E3%83%A2%E3%83%BC%E3%83%89)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#%E5%A4%96%E9%83%A8%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E7%9B%AE%E5%8D%B0%E4%BB%98%E3%81%91)

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

---

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