Metadata-Version: 2.4
Name: navig-social
Version: 0.1.1
Summary: NAVIG Social module — compose, schedule & publish across social networks (Studio + one-call fan-out). A first-party navig plugin (free, toggleable).
Author-email: NAVIG Development Team <opensource@navig.run>
License-Expression: Apache-2.0
Project-URL: Homepage, https://navig.run
Project-URL: Documentation, https://navig.run/docs
Keywords: navig,cli,agent,automation,plugin,social,publishing,tiktok,instagram
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: requests>=2.25.0
Dynamic: license-file

# navig-social

NAVIG **Social** — compose, schedule & publish across social networks. A first-party
navig plugin (free, toggleable), extracted from `navig-media`.

## What it does

- **Publish** to X/Twitter, Facebook Page, LinkedIn, Reddit, Instagram, Threads,
  Pinterest, Dev.to (and Telegram) through a common `BasePublisher` framework.
- **Fan-out** — publish one brief to many networks in a single call, with per-platform
  adaptation + UTM tagging: `navig social fan-out --file brief.json --to x,facebook,devto,telegram`.
- **Connect** — one-command OAuth: `navig social connect <network>` (vault-backed tokens).
- **Facebook Page admin** — `navig facebook` (`fb`): check/info/set-about/photos/backup/caption/delete.
- **Studio** — the deck composer + scheduler (`/api/deck/studio/*`), fed by the background
  `ScheduledPostService`.

## Commands

```
navig social status [--check]            # connected networks
navig social connect <network>           # OAuth connect (vault-backed)
navig social fan-out --file brief.json --to x,facebook,devto,telegram [--dry-run]
navig facebook check | info | photos | backup | caption | delete   (alias: navig fb)
```

## Install

Bundled with a full `navig` install (the `social` extra); standalone:
`navig store install pip:navig-social` — or `pip install navig-social` once published.
Requires `navig-core` in the same environment.

Credentials live in the NAVIG vault (`navig vault`) + config `adapters.social.<network>.*`.
Tokens are never printed.
