# PIIのマスキング (/ja/features/pii-redaction)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1259 · updated: 2026-07-30 -->
Related: [検索](/ja/features/search.md), [検索ハイライト](/ja/features/search-highlights.md), [Research Index](/ja/features/research.md), [スクレイピング](/ja/features/scrape.md), [スクレイピングを高速化](/ja/features/fast-scraping.md), [バッチスクレイピング](/ja/features/batch-scrape.md)

PIIのマスキングでは、返されたMarkdown内の個人を特定できる情報を、エージェント、ログ、ベクトルストア、分析パイプラインへ渡す前に置き換えます。

<div id="how-it-works">
  ## 仕組み [#仕組み]
</div>

スクレイピングリクエストで `redactPII: true` を設定します。Firecrawl は生成された markdown をマスキングし、マスキング済みの内容を `markdown` に返します。`formats` を渡す必要はありません。markdown がデフォルトの出力です。

<CodeGroup>
  <CodeBlockTabs defaultValue="Python" groupId="cli+curl+javascript+python">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="Python">
        Python
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="JavaScript">
        JavaScript
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="cURL">
        cURL
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="CLI">
        CLI
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

    <CodeBlockTab value="Python">
      ```python  
      from firecrawl import Firecrawl

      firecrawl = Firecrawl(
        # 開始にAPIキーは不要です — より高いrate limitsが必要な場合は追加してください:
        # api_key="fc-YOUR_API_KEY",
      )

      doc = firecrawl.scrape(
          "https://example.com/contact",
          redact_pii=True,
      )

      print(doc.markdown)
      ```
    </CodeBlockTab>

    <CodeBlockTab value="JavaScript">
      ```javascript  
      import { Firecrawl } from 'firecrawl';

      const firecrawl = new Firecrawl({
        // 開始にAPIキーは不要です — より高いレート制限が必要な場合は追加してください:
        // apiKey: "fc-YOUR_API_KEY",
      });

      const doc = await firecrawl.scrape('https://example.com/contact', {
        redactPII: true,
      });

      console.log(doc.markdown);
      ```
    </CodeBlockTab>

    <CodeBlockTab value="cURL">
      ```bash  
      # 開始にAPIキーは不要です — より高いrate limitsを利用するには -H "Authorization: Bearer fc-YOUR_API_KEY" を追加してください:
      curl -X POST https://api.firecrawl.dev/v2/scrape \
        -H 'Content-Type: application/json' \
        -d '{
          "url": "https://example.com/contact",
          "redactPII": true
        }'
      ```
    </CodeBlockTab>

    <CodeBlockTab value="CLI">
      ```bash  
      # 個人を特定できる情報をマスクした状態でmarkdownを返す。
      firecrawl https://example.com/contact --redact-pii
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</CodeGroup>

<div id="redaction-options">
  ## マスキング オプション [#マスキング-オプション]
</div>

ほとんどのリクエストでは、`redactPII: true` を指定します。マスキングを調整するには、options オブジェクトを渡します:

```json
{
  "redactPII": {
    "mode": "accurate",
    "entities": ["EMAIL", "PHONE", "SECRET"],
    "replaceStyle": "tag"
  }
}
```

| オプション          | 値                                                             | デフォルト      | 説明                                                                                            |
| -------------- | ------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------- |
| `mode`         | `accurate`, `aggressive`, `fast`                              | `accurate` | マスキングの方式です。`accurate` はモデルのみの経路を使用し、`aggressive` は追加のヒューリスティクスで再現率を高め、`fast` はモデルの呼び出しを省略します。 |
| `entities`     | `PERSON`, `EMAIL`, `PHONE`, `LOCATION`, `FINANCIAL`, `SECRET` | すべてのエンティティ | マスキングの対象を特定のエンティティ区分のみに限定します。                                                                 |
| `replaceStyle` | `tag`, `mask`, `remove`                                       | `tag`      | 対象箇所を `<EMAIL>` のようなタグに置き換える、`*` でマスクする、または文字を完全に削除します。                                       |

<Note>
  Firecrawl CLI と MCP Server では、単純なブール値によるマスキングを利用できます。高度なオプションは、完全な `redactPII` オプションオブジェクトを公開している API と SDKs で利用できます。
</Note>

<div id="response">
  ## レスポンス [#レスポンス]
</div>

マスキングに成功すると、`markdown` には秘匿化後の内容が含まれます。

```json
{
  "success": true,
  "data": {
    "markdown": "Contact us at <EMAIL> or <PHONE>.",
    "metadata": {
      "sourceURL": "https://example.com/contact"
    }
  }
}
```

コマンドラインで表示するには、Markdown をお好みのレンダラーにパイプしてください：

```bash title="cURL"
curl -X POST https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "url": "https://dlptest.com/sample-data.pdf",
    "redactPII": true
  }' | jq -r ".data.markdown" | glow
```

<div id="billing">
  ## 課金 [#課金]
</div>

PIIのマスキングには、1ページあたり5クレジットかかります: ベースのスクレイピングクレジット1に加え、マスキング用の追加4クレジットが必要です。

PDFを解析する場合、追加の各PDFページにも通常のPDF解析クレジットが発生し、さらにマスキングの追加料金も適用されます。

<div id="availability">
  ## 利用可能な箇所 [#利用可能な箇所]
</div>

PIIのマスキングは、Firecrawl がスクレイピングのオプションを受け付けるすべての場所でサポートされています。

* **スクレイピング** - `/v2/scrape` で `redactPII` を設定します。
* **クロール、バッチスクレイプ、検索** - `scrapeOptions` 内で `redactPII` を渡します。
* **解析** - multipart の `options` JSON 内で `redactPII` を渡します。
* **SDKs** - Python では `redact_pii` を使用します。JavaScript とその他の SDKs では、`redactPII` または各言語のオプション命名規則に従った形式を使用します。
* **CLI** - `firecrawl scrape` に `--redact-pii` を渡します。
* **MCP server** - 単純な真偽値でのマスキングを行う場合は、`firecrawl_scrape` ツールの引数に `"redactPII": true` を含めます。

> Firecrawl APIキーが必要な AI agent ですか？ 自動オンボーディング手順については、[firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) を参照してください。