Module errors

Modules extend the base agentshorts pipeline. Most module failures come from missing credentials, account approval, input shape drift, or version mismatch with the base product.

Analytics module

Symptom: reports are empty or attribution fields are missing.

Check that UTM parameters are present in generated links, analytics credentials are configured, and the date range includes the test campaign. Re-run with a small fixture before importing a full campaign export.

Clip Harvester module

Symptom: source clips are skipped or marked unsafe.

Confirm the source URL is reachable, the account has permission to reuse the clip, and the local safety scanner can write its output directory. If the error relates to takedown handling, follow the evidence process in docs/runbooks/dmca-takedown.md.

TikTok Publisher module

Symptom: upload fails, account is not authorized, or posting returns a provider error.

Confirm the TikTok account has the required API access and that OAuth credentials are current. Many publishing errors are provider-side approval or quota issues rather than local code defects.

Viral Captions module

Symptom: captions are blank, malformed, or rejected by the renderer.

Check the input transcript, caption length limits, and selected language. Re-run with a short transcript and inspect the generated caption JSON before rendering video.

Version mismatch

If a module error appears immediately after upgrading the base product, reinstall dependencies and compare the module README against the current base version. Send support the module name, base version, command, and redacted output.