Skip to main content

Export Intercom Help Center article URLs — ready to feed into AI tools like NotebookLM.

Project description

Intercom Docs Exporter

Export your Intercom Help Center article URLs into a single file. Filter by tags, collections, and publish state. Output as TXT or CSV.

Built to quickly feed help center docs into AI tools like NotebookLM.

Features

  • Filter articles by publish state, tags, and collections
  • Export as plain URL list (TXT) or with metadata (CSV)
  • Web interface for non-technical users
  • CLI for automation and scripting
  • Stateless: your API token is never stored

Quick Start (Web)

Visit intercom-docs-exporter.onrender.com and paste your Intercom API token.

Quick Start (CLI)

pip install intercom-docs-exporter

# Export all published articles
intercom-docs-exporter --token $INTERCOM_TOKEN

# Export with filters
intercom-docs-exporter --token $INTERCOM_TOKEN --include-tag Internal --format csv -o articles.csv

# List collections
intercom-docs-exporter --token $INTERCOM_TOKEN --list-collections

Examples

Feed your help center into NotebookLM:

# Export all published article URLs to a file
intercom-docs-exporter --token $INTERCOM_TOKEN -o urls.txt
# Upload urls.txt to NotebookLM as a source

Export only public-facing docs as CSV:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --exclude-tag Internal \
  --exclude-tag Draft \
  --format csv \
  -o public_articles.csv

Export a specific collection:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --collection "Getting Started" \
  -o getting_started.txt

Export everything except one collection:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --exclude-collection "Internal Docs" \
  --format csv \
  -o external.csv

Combine tag and collection filters:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --collection "API Reference" \
  --include-tag "v2" \
  --exclude-tag "deprecated" \
  -o api_v2.txt

Include draft articles too:

intercom-docs-exporter --token $INTERCOM_TOKEN --state both -o all_articles.txt

Help

intercom-docs-exporter --help
Option Description Default
--token Intercom API access token required
--state published, draft, or both published
--include-tag Only include articles with this tag (repeatable) all
--exclude-tag Exclude articles with this tag (repeatable) none
--collection Only include this collection (repeatable) all
--exclude-collection Exclude this collection (repeatable) none
--format txt or csv txt
-o, --output Output file path stdout
--list-collections List available collections and exit

Getting your API token:

  1. Go to your Intercom Developer Hub
  2. Select your app → Authentication
  3. Copy your access token

Your token is only used for the current request and is never stored.

Contributing

See CONTRIBUTING.md.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

intercom_docs_exporter-0.4.1.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

intercom_docs_exporter-0.4.1-py3-none-any.whl (18.2 kB view details)

Uploaded Python 3

File details

Details for the file intercom_docs_exporter-0.4.1.tar.gz.

File metadata

  • Download URL: intercom_docs_exporter-0.4.1.tar.gz
  • Upload date:
  • Size: 21.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.8

File hashes

Hashes for intercom_docs_exporter-0.4.1.tar.gz
Algorithm Hash digest
SHA256 01986581f202e4a849cc5a1643f939b69c95ecdb0cb3b5170d1e21467ec1af5f
MD5 f3d49d785c87e4266d755cf084b5c91b
BLAKE2b-256 bb42fb6fcebdd168bec21423407daa88175e827eb86ea35959b02021f1047c0f

See more details on using hashes here.

File details

Details for the file intercom_docs_exporter-0.4.1-py3-none-any.whl.

File metadata

File hashes

Hashes for intercom_docs_exporter-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 11a41438f6aa1b5806b5659bcf9a23b51463097c6696025f4ff05b6d98dcf536
MD5 5c9cf536a27670dfe8a45e6885c154bb
BLAKE2b-256 3fb7d8c710b3e8c2c52a451fa0aa12898e492be90344be25dd0e07ea60141765

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page