Skip to content

denkiwakame/arxiv2notion

Repository files navigation

arxiv2notion

build lint Changelog GitHub release

Supported Format

arxiv openreview acl

Easy-to-use arXiv clipper for Notion based on Notion API

demo notion

⬇️ Installation

a. Install via Chrome Store

b. Install Manually

⚙️ Setup

1. Add arxiv2notion integration

  • navigate to My Integrations
  • + New Integration
    • associated workspace: select your workspace where you save arXiv articles
    • Type: select Internal
    • name: set any name of your choice

Note

For more detailed information about Notion integration, please refer to the official documentation at https://developers.notion.com/docs/getting-started.

2. Configure the extension

  • right-click on the extension icon > Options
    • copy integration id (not the secret token!) (see figures below) from https://www.notion.so/my-integrations/internal/${integration-id}
    • paste the integration id and click on + button.
    • if your entered id is valid, you can see the following callback messages.

Note

To enhance security, arxiv2notion retrieves the Notion API key (integration secrets) on-demand through integration ID instead of storing it directly in Chrome local storage. Please ensure you are logged into notion.so while using this extension.

3. Create databases in Notion

from template (recommended)

  • clone the public template here to your own notion workspace
  • add connection to target databases via ... > (scroll down...) Connect to > {your integration name}
  • Integration will have access writes to all child DBs.

multiple_db

or manually

Caution

Do NOT create a new database by /database ! Make sure to create properties with exactly the same names and types as those listed.

property type
Title Title
URL URL
Authors Multi-Select
Abstract Text
Published Date
Comments URL
Publisher Select

Note

migration from v0.1.x → v1.0.0

  • We changed Authors type and added Published Comments property from v1.0.0.
  • Change your existing database properties as follows, you can easily integrate new features to your existing Notion database!
property type(^v0.1.x) type(v1.0.0+)
Authors Text Multi-Select
Published -- Date
Comments -- URL

Tip

You can add extra columns of your choice alongside the default ones in your databases.

💡 w/ Notion Formula (optional)

  • Notion Formula allows you to add custom autofill property defined by formula.
  • For instance, replace(URL, "arxiv", "ar5iv") formula adds an ar5iv link column by substituting "arxiv.org" with "ar5iv.org" 🚀

💡 w/ Notion AI Property (optional)

  • Notion AI Property allows you to add custom autofill property to each DB record.
  • Add column to your Notion DB and select AI custom autofill
  • Set any prompt you like (e.g. summarization, extracting key ideas ...)
  • Save an article via arxiv2notion ,and then the preset AI property will be automatically generated. image

🧑‍💻 Build locally (for Developers)

$ git clone https://github.com/denkiwakame/arxiv2notion.git
$ npm install
$ npm run build
$ npm run watch # debug locally
$ npm run pack  # packaging to zip

Contributors