Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ariary/Notionion

Notion as an HTTP proxy
https://github.com/ariary/Notionion

hack http-proxy notion notion-api proxy

Last synced: 30 days ago
JSON representation

Notion as an HTTP proxy

Awesome Lists containing this project

README

        



notionion πŸ§…




Use Notion as an HTTP proxy.

πŸ«€Like having Burp in your notetaking app

---

![demo](https://github.com/ariary/Notionion/blob/main/img/demo-fast.gif)

---


Why? πŸ€”


Mainly for fun of adding a blade to the Swiss army knife that is notion.
The purpose is to provide an HTTP proxy which takes advantage of the Notion benefits

  • Cross-platform (Windows/MacOS, browsers, mobile)

  • Shared with authentication

  • Accomplished notetaking app (GUI provided, ease HTTP packet manipulation, add notes)




How? πŸ€·β€β™‚οΈ


Just use notion as usual and launch notionion.

---


roughly inspired by the great idea of OffensiveNotion!

## Quickstart

**Set-up** ([details](#-set-up))
1. Create the "Proxy page" in Notion
2. Give the permissions to `notionion` to access the Proxy page

**Run** ([details](#-run))

3. Perform HTTP request
4. Modify it trough the "Proxy page" in Notion
5. See result of request

### πŸ—οΈ Set-up

#### Create the "Proxy page" in Notion

You can duplicate the template [notionion template](https://fluff-grade-468.notion.site/notionion_template-f95213ec89a04f66ad895ddac850d33e)

#### Give the permissions to `notionion` to access the Proxy page
* Go to the [Notion API developer page](https://developers.notion.com/) and log in. Create an Integration user (`New integration`). Copy that user's API key
* Copy the "Proxy page" Url
* In browser: only copy the URL
* On desktop app: `CTRL+L`
* Add your Notion Developer API account to this page (In the upper-right corner of your Notion page, click ***"Share"*** and ***"Invite"***)
* Install `notionion` [see](#install)

#### Declare environment variables to specify the notion proxy page:
```shell
source env.sh
# Alternatively, you can just export NOTION_TOKEN (which is the api key) & NOTION_PAGE_URL
```

### πŸ‘Ÿ Run

```shell
notionion
```

## Install
* **From release**: `curl -lO -L https://github.com/ariary/notionion/releases/latest/download/notionion && chmod +x notionion`
* **Build it**: `git clone https://github.com/ariary/notionion && make before.build && make build.notion` *(need `go`)*
* **with `go`**:`go install github.com/ariary/notionion@latest`